EVT_UCX_USBDEVICE_DISABLE fonction de rappel (ucxusbdevice.h)

  • Article

Implémentation du pilote client qu’UCX appelle pour libérer les ressources du contrôleur associées à l’appareil et à son point de terminaison par défaut.

Syntaxe

EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;

void EvtUcxUsbdeviceDisable(
  [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_DISABLE.

Valeur de retour

None

Remarques

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

Lorsque le pilote client a libéré des ressources de contrôleur, il termine la requête WDFREQUEST. Une fois l’opération terminée, la seule fonction de rappel appelée par UCX référençant ce périphérique USB est EVT_UCX_USBDEVICE_ENABLE.

Bien que l’appareil soit désactivé, UCX ne planifie pas les transferts pour celui-ci.

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

Le pilote client retourne l’achèvement status dans La requête. Le pilote peut effectuer l’opération WDFREQUEST de manière asynchrone.

Exemples

VOID
UsbDevice_EvtUcxUsbDeviceDisable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)


{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceDisable = (PUSBDEVICE_DISABLE)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