IWMDMDevice2::GetFormatSupport2 メソッド (mswmdm.h)
GetFormatSupport2 メソッドは、オーディオ コーデックとビデオ コーデック、MIME ファイル形式など、デバイスでサポートされている形式を取得します。
構文
HRESULT GetFormatSupport2(
[in] DWORD dwFlags,
[out] _WAVEFORMATEX **ppAudioFormatEx,
[out] UINT *pnAudioFormatCount,
[out] _VIDEOINFOHEADER **ppVideoFormatEx,
[out] UINT *pnVideoFormatCount,
[out] WMFILECAPABILITIES **ppFileType,
[out] UINT *pnFileTypeCount
);
パラメーター
[in] dwFlags
オーディオ形式、ビデオ形式、MIME の種類を指定する DWORD。 このフラグは、アプリケーションがサービス プロバイダーに入力を要求する内容を指定します。 呼び出し元は、次の 3 つの値のうち 1 つ以上を設定できます。
| 値 | 説明 |
|---|---|
| WMDM_GET_FORMAT_SUPPORT_AUDIO | サービス プロバイダーは、オーディオ パラメーターを入力する必要があります。 |
| WMDM_GET_FORMAT_SUPPORT_VIDEO | サービス プロバイダーは、ビデオ パラメーターを入力する必要があります。 |
| WMDM_GET_FORMAT_SUPPORT_FILE | サービス プロバイダーは、ファイル パラメーターを入力する必要があります。 |
[out] ppAudioFormatEx
デバイスでサポートされているオーディオ コーデックとビット レートに関する情報を指定する _WAVEFORMATEX構造体の 配列へのポインター。 このパラメーターのメモリは Windows Media デバイス マネージャーによって割り当てられ、呼び出し元が Win32 関数 CoTaskMemFree を使用して解放する必要があります。
[out] pnAudioFormatCount
オーディオ形式の数を指定する整数へのポインター。
[out] ppVideoFormatEx
デバイスでサポートされているビデオ コードと形式に関する情報を指定する _VIDEOFORMATEX 構造体の配列へのポインター。 このパラメーターのメモリは Windows Media デバイス マネージャーによって割り当てられ、呼び出し元が Win32 関数 CoTaskMemFree を使用して解放する必要があります。
[out] pnVideoFormatCount
ビデオ形式の数を指定する整数へのポインター。
[out] ppFileType
WMFILECAPABILITIES ファイル型オブジェクトの配列へのポインター。 このパラメーターのメモリは Windows Media デバイス マネージャーによって割り当てられ、呼び出し元が Win32 関数 CoTaskMemFree を使用して解放する必要があります。
[out] pnFileTypeCount
ファイルの種類の数を指定する整数へのポインター。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャー エラー コード
注釈
このメソッドは、ビデオ形式を処理するために IWMDMDevice::GetFormatSupport を拡張します。 ただし、形式のサポートを取得するための推奨される方法は、 IWMDMDevice3::GetFormatCapability です。 GetFormatCapability がサポートされていない場合、デバイスはおそらくビデオをサポートせず、GetFormatSupport で十分です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | mswmdm.h |
| Library | Mssachlp.lib |