Platform SDK: DirectX

IKsPropertySet::QuerySupport

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

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

パラメータ

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

戻り値

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

成功すれば S_OK (「注意」を参照すること)、失敗すれば次のエラー値のいずれかを返す。

E_NOTIMPL (「注意」を参照)
E_POINTER

注意

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

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。