Função UfxDevicePortDetectCompleteEx (ufxclient.h)

Artigo
02/07/2025

Notifica a UFX sobre o tipo de porta detectado e, opcionalmente, solicita uma ação.

Sintaxe

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

Parâmetros

[in] UfxDevice

Um identificador para um objeto de dispositivo UFX que o driver criou chamando UfxDeviceCreate.

[in] PortType

Contém um valor de enumeração do tipo USBFN_PORT_TYPE.

[in] Action

Contém um valor de enumeração do tipo USBFN_ACTION.

Valor de retorno

Nenhum

Observações

O driver cliente chama UfxDevicePortDetectCompleteEx após a conclusão da detecção de porta, normalmente de sua função de retorno de chamada EVT_UFX_DEVICE_PORT_DETECT. Em algumas plataformas, o UFX pode usar o tipo de porta relatado para notificar o gerenciador de bateria da corrente máxima que ele pode extrair da porta USB.

Se o parâmetro Action for definido como UsbfnActionNoCad, a UFX não notificará o gerenciador de baterias.

Se o parâmetro de Ação for definido como UsbfnActionDetectProprietaryCharger, a UFX solicitará que o driver cliente inicie a detecção de carregador proprietário chamando a função de retorno de chamada EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER do driver cliente.

O snippet a seguir mostra como um driver cliente chama 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
de cliente com suporte mínimo	Windows 10
da Plataforma de Destino	Windows
cabeçalho	ufxclient.h
biblioteca	ufxstub.lib
IRQL	DISPATCH_LEVEL

Partilhar via