EVT_UCX_USBDEVICE_ENABLE fonction de rappel (ucxusbdevice.h)

Article
02/29/2024

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

Partager via