Partager via


EVT_UCX_USBDEVICE_ENABLE fonction de rappel (ucxusbdevice.h)

Implémentation du pilote client qui appelle UCX pour programmer des informations sur l’appareil et son point de terminaison de contrôle par défaut dans le contrôleur.

Syntaxe

EVT_UCX_USBDEVICE_ENABLE EvtUcxUsbdeviceEnable;

VOID EvtUcxUsbdeviceEnable(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

Paramètres

[in] UcxController

Handle du contrôleur UCX reçu par le pilote client lors d’un appel précédent à la méthode UcxControllerCreate.

[in] Request

Structure de type USBDEVICE_ENABLE.

Valeur de retour

Aucun

Remarques

Le pilote client UCX inscrit cette fonction de rappel avec l’extension UCX (Host Controller Extension) USB en appelant la méthode UcxUsbDeviceCreate.

Pour passer l’appareil à l’état souhaité, le pilote du contrôleur hôte communique avec le matériel pour terminer la requête.

Dans cette fonction de rappel, le pilote client prépare le contrôleur à accepter et planifier les transferts sur le point de terminaison de contrôle par défaut du périphérique USB.

Une fois le pilote terminé, il termine wdFREQUEST.

Le pilote client retourne l’état d’achèvement dans demande. Le pilote peut effectuer l’opération WDFREQUEST de manière asynchrone.

Exemples

VOID
UsbDevice_EvtUcxUsbDeviceEnable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)
    
{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEnable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceEnable = (PUSBDEVICE_ENABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Exigences

Exigence Valeur
plateforme cible Windows
version minimale de KMDF 1.0
version minimale de UMDF 2.0
d’en-tête ucxusbdevice.h (include Ucxclass.h)
IRQL DISPATCH_LEVEL

Voir aussi

UcxUsbDeviceCreate