Microsoft DirectX 8.0 (C++)

IKsPropertySet::QuerySupport

プロパティ セット内のプロパティが、ポートまたはデバイスによってサポートされているかどうかを決定する。

HRESULT QuerySupport(
  REFGUID rguidPropSet,
  ULONG ulId,
  PULONG pulTypeSupport
);

パラメータ

rguidPropSet
問い合わせるべきプロパティ セットを表す GUID への参照 (C++) またはアドレス (C)。
ulId
アクセスすべきプロパティ セット内の項目。項目は 0 から始まるインデックス番号を割り当てられており、特定のプロパティ セット GUID では常に同じである。
pulTypeSupport
プロパティのサポートに関する情報を受け取る変数のアドレス。この変数は、次のフラグのいずれかまはた両方を受け取ることができる。「注意」を参照すること。
KSPROPERTY_SUPPORT_GET
プロパティ項目は取得できる。
KSPROPERTY_SUPPORT_SET
プロパティ項目は設定できる。

戻り値

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

成功した場合は S_OK を返す。「注意」を参照すること。

失敗した場合は、次のいずれかのエラー値を返す。

E_NOTIMPL (「注意」を参照)
E_POINTER

注意

セット内で特定のプロパティをサポートするかどうかは、プロパティ セットの定義に依存する。関心のあるプロパティ セットについては、ハードウェア メーカーの仕様を参照すること。

ある仕様ではプロパティがサポートされていない場合に S_OK を返し、ほかの仕様では E_NOTIMPL を返す。プロパティがサポートされているかどうかを確認するには、このメソッドの戻り値と、pulTypeSupport の戻り値の両方をチェックする。S_OK が返されても、pulTypeSupport に有効なフラグが含まれていない場合は、そのプロパティはサポートされていない。

動作環境

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