EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER fonction de rappel (ucxcontroller.h)
Implémentation du pilote client qu’UCX appelle pour récupérer le numéro de trame 32 bits actuel.
Syntaxe
EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER EvtUcxControllerGetCurrentFramenumber;
NTSTATUS EvtUcxControllerGetCurrentFramenumber(
[in] UCXCONTROLLER UcxController,
[out] PULONG FrameNumber
)
{...}
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 .
[out] FrameNumber
Pointeur vers le numéro de trame 32 bits actuel.
Valeur retournée
Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false.
Remarques
Le pilote client UCX inscrit son implémentation EVT_UCX_CONTROLLER_GET_CURRENT_FRAMENUMBER avec l’extension du contrôleur hôte USB (UCX) en appelant la méthode UcxControllerCreate .
Exemples
NTSTATUS
Controller_EvtControllerGetCurrentFrameNumber(
UCXCONTROLLER UcxController,
PULONG FrameNumber
)
{
UNREFERENCED_PARAMETER(UcxController);
//
// TODO: Return the current 32-bit frame number. Do not access the
// controller registers if the controller is not in D0.
//
*FrameNumber = 0xFFFFFFFF;
DbgTrace(TL_INFO, Controller, "Controller_EvtControllerGetCurrentFrameNumber");
return STATUS_SUCCESS;
}
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
Version KMDF minimale | 1.0 |
Version UMDF minimale | 2.0 |
En-tête | ucxcontroller.h (inclure Ucxclass.h) |
IRQL | PASSIVE_LEVEL |