IKsDeviceFunctions::RegisterAdapterObjectEx メソッド (ks.h)
IKsDeviceFunctions::RegisterAdapterObjectEx メソッドは、DMA アダプター オブジェクトを AVStream に登録します。 Win64 プラットフォーム用にコンパイルされたすべてのドライバーでは、 KsDeviceRegisterAdapterObject の代わりにこのメソッドを使用する必要があります。
構文
NTSTATUS RegisterAdapterObjectEx(
[in] PADAPTER_OBJECT AdapterObject,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] ULONG NumberOfMapRegisters,
[in] ULONG MaxMappingsByteCount,
[in] ULONG MappingTableStride
);
パラメーター
[in] AdapterObject
デバイスのADAPTER_OBJECTへのポインター。 RegisterAdapterObjectEx を呼び出す前に、IoGetDmaAdapter を使用して取得する必要があります。
[in] DeviceDescription
呼び出し元が DMA オブジェクトを 登録している物理 デバイスの属性を記述するDEVICE_DESCRIPTION型の構造体へのポインター。
[in] NumberOfMapRegisters
ミニドライバーによる IoGetDmaAdapter の呼び出しから返されるマップ レジスタの数を指定します。
[in] MaxMappingsByteCount
1 つのマッピングに対してデバイスが処理できる最大バイト数を指定します。 AVStream を使用すると、連続する物理メモリの大きなチャンクを、DMA 転送の個々のマッピングにサイズ制限を課すデバイスの複数のスキャッタ/ギャザー要素に自動的に分割できます。 MaxMappingsByteCount に関する重要な追加情報については、KsDeviceRegisterAdapterObject リファレンス ページを参照してください。
[in] MappingTableStride
マッピング テーブルの各エントリに必要なバイト数を指定します。 この値は、少なくとも sizeof (KSMAPPING) である必要があり、必要に応じて大きくすることができます。
ミニドライバーは、コンテキスト情報として追加の領域を使用できます。
戻り値
RegisterAdapterObjectEx は、DMA オブジェクトが正常に登録された場合にSTATUS_SUCCESSを返します。 十分なメモリが使用できない場合、メソッドは STATUS_INSUFFICIENT_RESOURCES を返します。
注釈
64 ビット AVStream ドライバーでの DMA のサポートに関するページも参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows Server 2003 Service Pack 1 (SP1) 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |