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 mediante una llamada 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

None

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 baterías la corriente máxima que puede extraer del puerto USB.

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

Si el parámetro Action se establece en UsbfnActionDetectProprietaryCharger, UFX solicita que el controlador cliente inicie la detección del cargador propietario llamando a la función de devolución de llamada del controlador de cliente EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER .

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	Value
Cliente mínimo compatible	Windows 10
Plataforma de destino	Windows
Encabezado	ufxclient.h
Library	ufxstub.lib
IRQL	DISPATCH_LEVEL