Compartilhar via

Função UfxDevicePortDetectCompleteEx (ufxclient.h)

  • Artigo

Notifica a UFX sobre o tipo de porta que foi 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.

Retornar valor

Nenhum

Comentários

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 sobre a corrente máxima que pode extrair da porta USB.

Se o parâmetro Action estiver definido como UsbfnActionNoCad, o UFX não notificará o gerenciador de bateria.

Se o parâmetro Action estiver definido como UsbfnActionDetectProprietaryCharger, o UFX solicitará que o driver cliente inicie a detecção proprietária do carregador 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 de 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
Cliente mínimo com suporte Windows 10
Plataforma de Destino Windows
Cabeçalho ufxclient.h
Biblioteca ufxstub.lib
IRQL DISPATCH_LEVEL