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
目标平台 窗户
标头 ufxclient.h
ufxstub.lib
IRQL DISPATCH_LEVEL