次の方法で共有


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

こちらもご覧ください

IWMDMMetaData インターフェイス

メタデータ定数

QueryByIndex

ファイルにメタデータを設定する