KSPROPERTY_PIN_PROPOSEDATAFORMAT

クライアントは、KSPROPERTY_PIN_PROPOSEDATAFORMAT プロパティを使用して、ピン ファクトリによってインスタンス化されたピンが特定のデータ形式をサポートしているかどうかを判断します。

使用方法概要表

取得	設定	対象	プロパティ記述子の種類	プロパティ値の種類
はい	はい	フィルター	KSP_PIN	KSDATAFORMAT

備考

KSPROPERTY_PIN_PROPOSEDATAFORMAT には、KSDATAFORMAT 型の構造体が格納されており、提案されたデータ形式を指定します。 KSP_PIN を使用して、このプロパティを指定します。ここで、このメンバーは、該当するピン ファクトリを指定します。

KSPROPERTY_TYPE_GET をこのプロパティと組み合わせて使用すると、オーディオ ドライバーは、ピンの既定のデータ形式に関する情報を提供できます。 ドライバーが KSEVENT_PINCAPS_FORMATCHANGE をサポートしていない限り、このプロパティを実装する KSPROPERTY_TYPE_GET は省略可能です。

提案されたデータ形式でピンを設定または開くことができる場合、このプロパティを KSPROPERTY_TYPE_SET と組み合わせて使用すると、KS フィルターは STATUS_SUCCESS を返します。 ピンを提案されたデータ形式に設定できない場合は、STATUS_NO_MATCH が返されます。 その他のエラーの場合は、該当するエラーが返されます。 ドライバーが、KSPROPERTY_AUDIOSIGNALPROCESSING_MODES をサポートしている場合に、形式がオーディオ信号処理モードのいずれかでサポートされているときには、このプロパティは STATUS_SUCCESS を返す必要があります。

KSPROPERTY_TYPE_SET とこのプロパティを組み合わせて使用しても、実際にはデータ形式は変更されません。 クライアントは、KSPROPERTY_CONNECTION_DATAFORMAT を使用してデータ形式を変更します。 このプロパティを実装する KSPROPERTY_TYPE_SET は省略可能です。

要件

ヘッダー: ks.h (Ks.hを含む)

関連項目

KSP_PIN

KSDATAFORMAT

KSEVENT_PINCAPS_FORMATCHANGE

KS のプロパティ

KSPROPERTY

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES