UcmTcpciPortControllerSetHardwareRequestQueue 函数 (ucmtcpciportcontroller.h)
分配一个框架队列对象,UcmTcpciCx 将硬件请求调度到端口控制器。
语法
void UcmTcpciPortControllerSetHardwareRequestQueue(
UCMTCPCIPORTCONTROLLER PortControllerObject,
WDFQUEUE HardwareRequestQueue
);
参数
PortControllerObject
客户端驱动程序在上次调用 UcmTcpciPortControllerCreate 时收到的端口控制器对象的句柄。
HardwareRequestQueue
要分配的框架队列对象的句柄。
返回值
无
备注
创建端口控制器对象后,客户端驱动程序必须调用 UcmTcpciPortControllerSetHardwareRequestQueue 。 在调用 UcmTcpciPortControllerStart 之前,驱动程序必须仅调用此方法一次。
队列对象的父对象是端口控制器对象。
客户端驱动程序可以选择跨多个端口控制器对象使用相同的队列。 但是,在这种情况下,驱动程序必须确保端口控制器对象不会超过队列对象。 只有在停止所有端口控制器后,才能删除队列对象。 UcmTcpciCx 保证每个端口控制器对象一次只处理队列中的一个请求。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
标头 | ucmtcpciportcontroller.h |
IRQL | <=DISPATCH_LEVEL |