IAMVideoCompression

IAMVideoCompression インターフェイスは、ビデオ圧縮のプロパティを設定および取得します。

Windows Driver Model (WDM) デバイスの場合、WDM ドライバーが PROPSETID_VIDCAP_VIDEOCOMPRESSION プロパティ セットをサポートしていれば、WDM Video Capture Filter がこのインターフェイスを自動的に公開します。詳細については、Windows Driver Kit (WDK) のドキュメントを参照してください。

put_KeyFrameRate メソッドは、キー フレーム レートを設定します。

HRESULT 値を返します。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanKeyFrame フラグが設定されているかどうかを確認します。GetInfo メソッドは既定のキー フレーム レートも返します。

get_KeyFrameRate メソッドは、現在のキー フレーム レートを取得します。

HRESULT 値を返します。

キー フレーム レートとは、1 つのキー フレームあたりのフレーム数です。たとえば、レートが 15 の場合、15 フレームごとにキー フレームが発生します。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanKeyFrame フラグが設定されているかどうかを確認します。GetInfo メソッドは既定のキー フレーム レートも返します。

put_PFramesPerKeyFrame メソッドは、キー フレームあたりの予測 (P) フレームのレートを設定します。

HRESULT 値を返します。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanBFrame フラグが設定されているかどうかを確認します。GetInfo メソッドは既定の P フレーム レートも返します。

get_PFramesPerKeyFrame メソッドは、キー フレームあたりの予測 (P) フレームのレートを取得します。

HRESULT 値を返します。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanBFrame フラグが設定されているかどうかを確認します。GetInfo メソッドは既定の P フレーム レートも返します。

P フレームは MPEG 圧縮で使用されます。一般に、このプロパティは他の圧縮形式には適用されません。たとえば、キー フレームが 10 フレームごとに 1 回発生し、キー フレームあたり 3 つの P フレームがあるとします。この場合、P フレームはキー フレームの間に均等に配置されます。残りの 6 フレームは双方向 (B) フレームになります。

put_Quality メソッドは、圧縮品質を設定します。

HRESULT 値を返します。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanQuality フラグが設定されているかどうかを確認します。GetInfo メソッドは既定の品質も返します。

get_Quality メソッドは、現在の圧縮品質を取得します。

HRESULT 値を返します。

品質設定の正確な意味はフィルターによって異なります。

フィルターがこのメソッドをサポートしているかどうかを判断するには、IAMVideoCompression::GetInfo メソッドを呼び出し、pCapabilities パラメーターに CompressionCaps_CanQuality フラグが設定されているかどうかを確認します。GetInfo メソッドは既定の品質も返します。

put_WindowSize メソッドは、コンプレッサーが平均データ レートを維持しなければならないフレーム数を設定します。

HRESULT 値を返します。

get_WindowSize メソッドは、コンプレッサーが平均データ レートを維持するフレーム数を取得します。

HRESULT 値を返します。指定できる値には次のものがあります。

GetInfo メソッドは、フィルターの圧縮プロパティに関する情報 (機能や既定値を含む) を取得します。

HRESULT 値を返します。

記載されているパラメーターはいずれも NULL にすることができ、その場合メソッドはそのパラメーターを無視します。

アプリケーションは、バージョン文字列と説明文字列のバッファーを割り当てる必要があります。必要なバッファーのサイズを判断するには、pszVersion パラメーターと pszDescription パラメーターに NULL を指定してこのメソッドを呼び出します。pcbVersion と pcbDescription で返された値を使用してバッファーを割り当て、次のコードのようにメソッドを再度呼び出します。

// Get the size of the version and description strings, in bytes.
int cbVersion, cbDesc; 
hr = pCompress->GetInfo(NULL, &cbVersion, NULL, &cbDesc, 
    NULL, NULL, NULL, NULL);
if (SUCCEEDED(hr))
{
    // Allocate the buffers.
    WCHAR *pszVersion = new WCHAR[cbVersion / sizeof(WCHAR)];  
    WCHAR *pszDesc = new WCHAR[cbDesc / sizeof(WCHAR)];

    // Now query for the strings.
    hr = pCompress->GetInfo(pszVersion, &cbVersion, pszDesc, &cbDesc, 
        NULL, NULL, NULL, NULL);
    }
    delete [] pszVersion;
    delete [] pszDesc;
}

pCapabilities パラメーターは、どの圧縮プロパティがサポートされているか、ひいてはどの IAMVideoCompression メソッドがサポートされているかを示すフラグのセットを受け取ります。たとえば、CompressionCaps_CanKeyFrame フラグが返された場合、そのフィルターは IAMVideoCompression::get_KeyFrameRate メソッドと IAMVideoCompression::put_KeyFrameRate メソッドをサポートしています。

残りのパラメーターは、圧縮プロパティの既定値を受け取ります。サポートされていないプロパティ (pCapabilities で返されるフラグにより判断) については、対応する既定値が正しくない、または意味を持たない可能性があるため、無視する必要があります。

OverrideKeyFrame メソッドは、特定のフレームをキー フレームとして圧縮するようフィルターに指示します。

HRESULT 値を返します。指定できる値には次のものがあります。

フィルターがこのメソッドをサポートしている場合、これを使用して特定のフレームについて通常のキー フレーム配分を上書きできます。フィルターはキー フレームを作成した後、次のキー フレームをいつ作成すべきかを判断するためにカウントをリセットする場合があります。たとえば、キー フレーム レートが 10 で、アプリケーションがこのメソッドを使用してフレーム 5 をキー フレームとして強制した場合、フィルターは次のキー フレームを作成するまでさらに 10 フレーム (フレーム 15 まで) 待機する可能性があります。

OverrideFrameSize メソッドは、指定されたフレームのフレーム サイズを上書きします。

HRESULT 値を返します。指定できる値には次のものがあります。

フィルターがこのメソッドをサポートしている場合、IAMVideoCompression::GetInfo メソッドは pCapabilities パラメーターに CompressionCaps_CanCrunch フラグを返します。ただし、このフラグはフィルターがビット レートの設定をサポートしていることを示す場合もあるため、OverrideFrameSize メソッドがサポートされていることを保証するものではありません。