Microsoft DirectX 8.0 (C++)

IKsPropertySet::Get

プロパティ セット内の特定の項目に対応するデータを取得する。

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

パラメータ

rguidPropSet
アクセスすべきプロパティ セットを表す GUID への参照 (C++) またはアドレス (C)。
ulId
アクセスすべきプロパティ セット内の項目。項目は 0 から始まるインデックス番号を割り当てられており、特定のプロパティ セット GUID では常に同じである。
pInstanceData
Get 呼び出しの対象となるインスタンス データ。
ulInstanceLength
pInstanceData が指すバイト数。
pPropertyData
この項目から取得されるデータ。
ulDataLength
pPropertyData が指すバイト数。
pulBytesReturned
pPropertyData に書き込まれたバイト数を受け取る変数のアドレス。

戻り値

戻り値は、プロパティ セットの設計者によって決定される。

成功した場合は S_OK を返す。

失敗すると、メソッドは 1 つの E_POINTER を返す。

注意

pInstanceData pPropertyData の各データのフォーマットは、項目ごとに異なる。

動作環境

  ヘッダー : dsound.h で宣言。