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