IWMDMMetaData::QueryByIndex メソッド (mswmdm.h)

QueryByIndex メソッドは、index で指定されたプロパティの値を取得します。

構文

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

パラメーター

[in] iIndex

プロパティの 0 から始まるインデックスを指定する整数。 アイテムの数は、 GetItemCount 呼び出しによって取得されます。

[out] ppwszName

プロパティ名。 Windows Media デバイス マネージャーはこのメモリを割り当てます。呼び出し元は CoTaskMemFree を使用して解放する必要があります。

[out] pType

ppValue で返されるデータの種類を記述するWMDM_TAG_DATATYPE列挙値。

[out] ppValue

メソッドが成功した場合に値の内容を受け取るバイト配列へのポインター。 このメモリは Windows Media デバイス マネージャーによって割り当てられ、呼び出し元は CoTaskMemFree を使用して解放する必要があります。

[out] pcbLength

バイト配列 ppValue のサイズ (バイト単位) へのポインター。 値が文字列の場合、これには終了文字が含まれます。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。

• 標準 COM エラー コード
• HRESULT 値に変換された Windows エラー コード
• Windows Media デバイス マネージャー エラー コード

考えられるエラー コードの詳細な一覧については、「 エラー コード」を参照してください。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	mswmdm.h
Library	Mssachlp.lib

こちらもご覧ください

GetItemCount

IWMDMMetaData インターフェイス

QueryByName

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