Fonction UfxDevicePortDetectCompleteEx (ufxclient.h)

Article
02/26/2024

Avertit UFX du type de port détecté et demande éventuellement une action.

Syntaxe

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

Paramètres

[in] UfxDevice

Handle d’un objet d’appareil UFX que le pilote a créé en appelant UfxDeviceCreate.

[in] PortType

Contient une valeur d’énumération de type USBFN_PORT_TYPE.

[in] Action

Contient une valeur d’énumération de type USBFN_ACTION.

Valeur de retour

None

Remarques

Le pilote client appelle UfxDevicePortDetectCompleteEx une fois la détection de port terminée, généralement à partir de sa fonction de rappel EVT_UFX_DEVICE_PORT_DETECT . Sur certaines plateformes, UFX peut utiliser le type de port signalé pour informer le gestionnaire de batterie du courant maximal qu’il peut tirer du port USB.

Si le paramètre Action est défini sur UsbfnActionNoCad, UFX n’avertit pas du tout le gestionnaire de batterie.

Si le paramètre Action est défini sur UsbfnActionDetectProprietaryCharger, UFX demande que le pilote client lance la détection du chargeur propriétaire en appelant la fonction de rappel EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER du pilote client.

L’extrait de code suivant montre comment un pilote client appelle 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;

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Plateforme cible	Windows
En-tête	ufxclient.h
Bibliothèque	ufxstub.lib
IRQL	DISPATCH_LEVEL

Partager via