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

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

構文

HRESULT Get(
  [in]  REFGUID rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

パラメーター

[in] rguidPropSet

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

[in] ulId

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

[in] pInstanceData

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

[in] ulInstanceLength

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

[out] pPropertyData

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

[in] ulDataLength

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

[out] pulBytesReturned

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

戻り値

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

注釈

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

警告

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

要件

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

こちらもご覧ください

IKsPropertySet::Set