Función UfxDevicePortDetectCompleteEx (ufxclient.h)

Notifica a UFX sobre el tipo de puerto que se detectó y, opcionalmente, solicita una acción.

Sintaxis

void UfxDevicePortDetectCompleteEx(
  [in] UFXDEVICE       UfxDevice,
  [in] USBFN_PORT_TYPE PortType,
  [in] USBFN_ACTION    Action
);

Parámetros

[in] UfxDevice

Identificador de un objeto de dispositivo UFX que creó el controlador llamando a UfxDeviceCreate.

[in] PortType

Contiene un valor de enumeración de tipo USBFN_PORT_TYPE.

[in] Action

Contiene un valor de enumeración de tipo USBFN_ACTION.

Valor devuelto

Ninguno

Observaciones

El controlador cliente llama a ufxDevicePortDetectCompleteEx una vez completada la detección de puertos, normalmente desde su función de devolución de llamada EVT_UFX_DEVICE_PORT_DETECT. En algunas plataformas, UFX puede usar el tipo de puerto notificado para notificar al administrador de la batería del máximo actual que puede extraer del puerto USB.

Si el parámetro Action se establece en UsbfnActionNoCad, UFX no notifica al administrador de baterías en absoluto.

Si el parámetro Action está establecido en UsbfnActionDetectProprietaryCharger, UFX solicita que el controlador cliente inicie la detección de cargadores propietarios llamando a la función de devolución de llamada EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER del controlador cliente.

En el fragmento de código siguiente se muestra cómo un controlador cliente llama a 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;

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
de la plataforma de destino de	Windows
encabezado de	ufxclient.h
biblioteca de	ufxstub.lib
irQL	DISPATCH_LEVEL