IKsDeviceFunctions::RegisterAdapterObjectEx 方法 (ks.h)
IKsDeviceFunctions::RegisterAdapterObjectEx 方法向 AVStream 注册 DMA 适配器对象。 为 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
指向 DEVICE_DESCRIPTION 类型的结构的指针,该结构描述调用方为其注册 DMA 对象的物理设备的属性。
[in] NumberOfMapRegisters
指定从微型驱动程序对 IoGetDmaAdapter 的调用返回的映射寄存器数。
[in] MaxMappingsByteCount
指定设备可以处理单个映射的最大字节数。 使 AVStream 能够自动将大块连续物理内存分解为多个散点/收集元素,这些元素对 DMA 传输中的单个映射施加大小限制。 请参阅 KsDeviceRegisterAdapterObject 参考页上有关 MaxMappingsByteCount 的重要附加信息。
[in] MappingTableStride
指定映射表中每个条目所需的字节数。 此值必须至少 (KSMAPPING) 的大小,并且可以根据需要大。
微型驱动程序可以使用额外的空间作为上下文信息。
返回值
如果成功注册了 DMA 对象,RegisterAdapterObjectEx 将返回STATUS_SUCCESS。 如果内存不足,该方法返回STATUS_INSUFFICIENT_RESOURCES。
注解
另请参阅 在 64 位 AVStream 驱动程序中支持 DMA。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows Server 2003 Service Pack 1 (SP1) 及更高版本的 Windows 中可用。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |