EVT_UCX_USBDEVICE_DISABLE fonction de rappel (ucxusbdevice.h)
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 |