次の方法で共有


ピン Data-Range と交差プロパティ

いくつかのプロパティ要求は、オーディオ デバイスが入力ピンと出力ピンで処理できるオーディオ ストリームのデータ形式に関する情報を提供します。

ピンがサポートできるオーディオ ストリーム データ形式は、KSDATARANGE 派生構造体のKSMULTIPLE_ITEM配列で表されます。 ピン データ範囲のサポートは、フィルター上の次の 3 つの KSPROPSETID_Pin プロパティによって公開されます。

KSPROPERTY_PIN_DATARANGES このプロパティは、静的で、サポートされているすべての形式を表すデータ範囲を報告します。 通常、データ範囲はアダプター ドライバーの静的配列に含まれます。 KSPROPERTY_PIN_CONSTRAINEDDATARANGES このプロパティは、動的なデータ範囲を報告し、プロパティ要求時にサポートされる形式のサブセットを表します。 プロパティ ハンドラーには、実行時にサポートできるピンの形式を決定するロジックが含まれている必要があります。 たとえば、ハードウェア実装では、特定の形式の組み合わせで全二重をサポートできない DMA 制約が存在する可能性があります。 KSPROPERTY_PIN_DATAINTERSECTION このプロパティは、データ範囲の一覧からデータ形式を選択します。 選択は動的機能に基づいており、形式は、プロパティ要求時にドライバーがサポートできる形式のサブセットから取得されます。 このプロパティを使用するために、呼び出し元はデータ範囲の配列を提供します。 最初の要素から、プロパティ ハンドラーは、現在サポートできるデータ範囲が見つかるまで配列を検索します。 成功した場合、ハンドラーはそのデータ範囲から取得されたデータ形式を出力し、STATUS_SUCCESSを返します。 それ以外の場合、ハンドラーはSTATUS_NO_MATCHを返します。 オーディオ システム コンポーネントでは、KSPROPERTY_PIN_DATARANGESプロパティとKSPROPERTY_PIN_DATAINTERSECTION プロパティが使用されます。 ミニポート ドライバーは、これらのプロパティをサポートする必要があります。 KSPROPERTY_PIN_CONSTRAINEDDATARANGESのサポートは省略可能です。

詳細については、「オーディオ データ形式とデータ範囲を参照してください。

注意 KSPROPERTY_PIN_DATARANGESとKSPROPERTY_PIN_CONSTRAINEDDATARANGESは、それぞれ8バイト整列アドレスで始まります。