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)

另请参阅

KsDeviceRegisterAdapterObject