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を含む)