UfxDevicePortDetectCompleteEx 函数 (ufxclient.h)
通知 UFX 检测到的端口类型,并根据需要请求操作。
语法
void UfxDevicePortDetectCompleteEx(
[in] UFXDEVICE UfxDevice,
[in] USBFN_PORT_TYPE PortType,
[in] USBFN_ACTION Action
);
参数
[in] UfxDevice
驱动程序通过调用 UfxDeviceCreate 创建的 UFX 设备对象的句柄。
[in] PortType
包含 类型为 USBFN_PORT_TYPE 的枚举值。
[in] Action
包含 类型为 USBFN_ACTION 的枚举值。
返回值
无
备注
客户端驱动程序在端口检测完成后调用 UfxDevicePortDetectCompleteEx ,通常是从其 EVT_UFX_DEVICE_PORT_DETECT 回调函数。 在某些平台上,UFX 可能会使用报告的端口类型来通知电池管理器它可从 USB 端口吸收的最大电流。
如果 Action 参数设置为 UsbfnActionNoCad,则 UFX 根本不通知电池管理器。
如果 Action 参数设置为 UsbfnActionDetectProprietaryCharger,则 UFX 请求客户端驱动程序通过调用客户端驱动程序的 EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER 回调函数来启动专有充电器检测。
以下代码片段演示客户端驱动程序如何调用 UfxDevicePortDetectCompleteEx。
switch (OnAttach.AttachAction) {
case UsbfnPortDetected:
TraceInformation("Port Detected");
UfxDevicePortDetectComplete(
ControllerData->UfxDevice,
OnAttach.PortType);
break;
case UsbfnPortDetectedNoCad:
TraceInformation("Port Detected No CAD");
UfxDevicePortDetectCompleteEx(
ControllerData->UfxDevice,
OnAttach.PortType,
UsbfnActionNoCad);
break;
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
目标平台 | Windows |
标头 | ufxclient.h |
Library | ufxstub.lib |
IRQL | DISPATCH_LEVEL |