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