EVT_UCX_USBDEVICE_UPDATE fonction de rappel (ucxusbdevice.h)
Implémentation du pilote client que UCX appelle pour mettre à jour les propriétés de l’appareil.
Syntaxe
EVT_UCX_USBDEVICE_UPDATE EvtUcxUsbdeviceUpdate;
void EvtUcxUsbdeviceUpdate(
[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
Contient la structure USBDEVICE_UPDATE.
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.
Le pilote du contrôleur hôte communique avec le matériel pour mettre à jour les descripteurs, les paramètres LPM, si l’appareil est un hub et la latence de sortie maximale, si nécessaire.
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_EvtUcxUsbDeviceUpdate(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceUpdate");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
usbDeviceUpdate = (PUSBDEVICE_UPDATE)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 |