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 が プロパティで塗りつぶすバッファーを割り当てます。 必要なバッファー サイズを決定するには、PropertyData に NULL、DataLength に 0 を指定します。 Get メソッドは、必要なバッファー サイズを BytesReturned で返します。

警告

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

要件

要件 値
対象プラットフォーム デスクトップ
Header ksproxy.h (Ksproxy.h、Dsound.h を含む)

こちらもご覧ください

IKsPropertySet::Set