IKsPropertySet::Get メソッド (ksproxy.h)

Get メソッドは、プロパティ セット GUID とプロパティ識別子によって識別されるプロパティを取得します。

構文

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

パラメーター

[in] PropSet

プロパティ セットを識別する GUID。

[in] Id

プロパティ セット内のプロパティの識別子。

[in] InstanceData

プロパティのインスタンス データへのポインター。

[in] InstanceLength

InstanceData のバッファーのサイズ (バイト単位)します。

[out] PropertyData

プロパティの値を受け取るバッファーへのポインター。

[in] DataLength

PropertyData のバッファーのサイズ (バイト単位)します。

[out] BytesReturned

Get がバッファーに格納 データのサイズ (バイト単位) を受け取る変数へのポインター PropertyData。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラー コードを返します。

備考

プロパティを取得するには、バッファーを割り当てます。このバッファー Get によってプロパティが埋め込まれます。 必要なバッファー サイズを決定するには、PropertyDataNULL を指定し、DataLength 0 を指定します。 Get メソッドは、BytesReturned で必要なバッファー サイズ返します。

警告

ヘッダー ファイル ksproxy.h と dsound.h、IKsPropertySet インターフェイスの類似したバージョンを定義します。 KS プロキシ モジュールを必要とするアプリケーションでは、ksproxy.hで定義されているバージョンを使用する必要があります。 アプリケーションに ksproxy.h と dsound.hの両方を含める必要がある場合、コンパイラが最初にスキャンするヘッダー ファイルは、コンパイラによって使用 IKsPropertySet の定義です。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	ksproxy.h (Ksproxy.h、Dsound.h を含む)

関連項目

IKsPropertySet::Set