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 を含む) |