EVT_UCX_USBDEVICE_ENABLE fonction de rappel (ucxusbdevice.h)

  • Article

Implémentation du pilote client qu’UCX appelle 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 que le pilote client a reçu lors d’un appel précédent à la méthode UcxControllerCreate .

[in] Request

Structure de type USBDEVICE_ENABLE.

Valeur de retour

None

Remarques

Le pilote client UCX inscrit cette fonction de rappel avec l’extension du contrôleur hôte USB (UCX) en appelant la méthode UcxUsbDeviceCreate .

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

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 pour le périphérique USB.

Une fois le pilote terminé, il termine le WDFREQUEST.

Le pilote client retourne l’achèvement status dans Requête. Le pilote peut effectuer le 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);
}

Configuration requise

Condition requise Valeur
Plateforme cible Windows
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête ucxusbdevice.h (inclure Ucxclass.h)
IRQL DISPATCH_LEVEL

Voir aussi

UcxUsbDeviceCreate