IWMDMMetaData::QueryByName メソッド (mswmdm.h)
QueryByName メソッドは、name で指定されたプロパティの値を取得します。
構文
HRESULT QueryByName(
[in] LPCWSTR pwszTagName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **pValue,
[out] UINT *pcbLength
);
パラメーター
[in] pwszTagName
プロパティ名を指定するワイド文字の null で終わる文字列へのポインター。 標準のプロパティ名定数の一覧は、 メタデータ定数で指定します。
[out] pType
pValue によって取得されるデータの種類を記述するWMDM_TAG_DATATYPE列挙値。
[out] pValue
メソッドが成功した場合に値の内容を受け取るバイト配列へのポインター。 Windows Media デバイス マネージャーはこのメモリを割り当て、呼び出し元は CoTaskMemFree を使用して解放する必要があります。
[out] pcbLength
バイト配列 ppValue のサイズ (バイト単位) へのポインター。 値が文字列の場合、これには終了文字が含まれます。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャー エラー コード
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |