IKsPropertySet::QuerySupport
QuerySupport メソッドは、プロパティ セット内のプロパティがポートまたはデバイスでサポートされているかどうかを確認します。
HRESULT
QuerySupport(
REFGUID rguidPropSet,
ULONG ulId,
PULONG pulTypeSupport
);
パラメータ
rguidPropSet
クエリするプロパティ セットを表す GUID への参照 (C++ の場合) または GUID のアドレス (C の場合) です。ulId
アクセスするプロパティ セット内の項目です。項目には 0 から始まるインデックス番号が割り当てられ、特定のプロパティ セットについては常に同じです。pulTypeSupport
プロパティのサポートに関する情報を受け取る変数のアドレスです。この変数は、次のフラグの一方または両方を受け取ることができます。「解説」を参照してください。値 説明 KSPROPERTY_SUPPORT_GET プロパティ項目を取得できます。 KSPROPERTY_SUPPORT_SET プロパティ項目を設定できます。
戻り値
戻り値は、プロパティ セットの設計者によって決定されます。
成功した場合は、S_OK を返します。「解説」を参照してください。
失敗した場合は、次のいずれかのエラー値を返します。
リターン コード |
E_NOTIMPL (「解説」を参照してください。) |
E_POINTER |
解説
セット内の一部のプロパティがサポートされており、他のプロパティがサポートされていないことが有効であるかどうかは、プロパティ セットの定義によって異なります。関心があるプロパティ セットについては、ハードウェアの製造元の仕様を参照してください。
プロパティがサポートされていない場合、実装によって S_OK を返すこともあれば、E_NOTIMPL を返すこともあります。プロパティがサポートされていることを確認するには、このメソッドの戻り値と pulTypeSupport の戻り値の両方をチェックします。S_OK が返されても、pulTypeSupport に有効なフラグが含まれていない場合、そのプロパティはサポートされていません。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容