KsDeviceRegisterAdapterObject 関数 (ks.h)

[アーティクル]
03/05/2024

KsDeviceRegisterAdapterObject 関数は、指定されたデバイスで DMA の分散/収集を実行するために、DMA アダプターオブジェクトを AVStream に登録します。 Win64 用にコンパイルされたすべてのドライバーでは、代わりに IKsDeviceFunctions::RegisterAdapterObjectEx を使用する必要があります。

構文

void KsDeviceRegisterAdapterObject(
  [in] PKSDEVICE       Device,
  [in] PADAPTER_OBJECT AdapterObject,
  [in] ULONG           MaxMappingsByteCount,
  [in] ULONG           MappingTableStride
);

パラメーター

[in] Device

アダプターオブジェクトを登録する AVStream デバイスを表す KSDEVICE 構造体へのポインター。

[in] AdapterObject

DMA コントローラーを表す IoGetDmaAdapter によって返されるDMA_ADAPTER構造体へのポインター。

[in] MaxMappingsByteCount

このパラメーターは、デバイスが 1 つのマッピングに対して処理できる最大バイト数を指定します。 AVStream を使用すると、連続する物理メモリの大きなチャンクを、DMA 転送の個々のマッピングにサイズ制限を課すデバイスの複数のスキャッタ/ギャザー要素に自動的に分割できます。改ページがページ境界で発生することは保証されません。

[in] MappingTableStride

このパラメーターは、マッピングテーブル内の各エントリに必要なバイト数を指定します。これは、少なくとも sizeof (KSMAPPING) である必要があり、必要に応じて大きくすることができます。

ミニドライバーは、コンテキスト情報として追加の領域を使用できます。

戻り値

なし

解説

KsDeviceRegisterAdapterObject を呼び出すミニドライバーは、IoGetDmaAdapter を介してアダプターオブジェクトを以前に取得する役割を担います。

また、ミニドライバーがデバイス上のフィルター上の任意のピンのKSPIN_FLAG_GENERATE_MAPPINGS フラグを指定する場合、ミニドライバーは、データを処理する前に KsDeviceRegisterAdapterObject を 呼び出す必要があることにも注意してください。このフラグの詳細については、 KSPIN_DESCRIPTOR_EXのリファレンスページを参照してください。 AVStream DMA サービスに関するページも参照してください。

MaxMappingByteCount を 1 つの物理ページの長さに設定した場合、マッピングが 1 つの物理ページに存在することは保証されません。さらに、上のメンバーの説明で説明したように、 MaxMappingsByteCount を設定しても、ページ境界で中断が発生することは保証されません。ページ境界で区切りが必要な場合は、マッピングサイズに制限を指定しないことを検討してください。代わりに、返された散布図/収集マッピングをページアラインチャンクに手動で分割します。

64 ビット AVStream ドライバーでの DMA のサポートに関するページも参照してください。