UfxDevicePortDetectCompleteEx, fonction (ufxclient.h)

Article
02/07/2025

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 vers un objet de périphérique 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

Aucun

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 au pilote client de lancer 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;

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
plateforme cible	Windows
d’en-tête	ufxclient.h
bibliothèque	ufxstub.lib
IRQL	DISPATCH_LEVEL

Partager via