fonction de rappel HWN_CLIENT_SET_STATE (hwnclx.h)
Implémenté par le pilote client pour définir l’état du composant de notification matérielle. Elle est appelée lorsqu’un utilisateur souhaite modifier l’état d’un pilote.
Syntaxe
HWN_CLIENT_SET_STATE HwnClientSetState;
NTSTATUS HwnClientSetState(
[in] PVOID Context,
[in] PVOID Buffer,
[in] ULONG BufferLength,
[out] PULONG BytesWritten
)
{...}
Paramètres
[in] Context
Pointeur vers les informations de contexte du pilote client. Cet espace mémoire est disponible pour être utilisé par le pilote client. Il est alloué dans le cadre de l’espace de contexte de l’objet framework par WdfDeviceCreate. Pour plus d’informations, consultez HWN_CLIENT_REGISTRATION_PACKET et Framework Object Context Space.
[in] Buffer
Mémoire tampon de BufferLength octets contenant une structure HWN_HEADER, y compris une ou plusieurs structures HWN_SETTINGS qui spécifient les notifications matérielles à définir.
[in] BufferLength
Taille de mémoire tampon en octets.
[out] BytesWritten
Pointeur vers une variable qui indique le nombre d’octets écrits par la fonction.
Valeur de retour
Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur NTSTATUS approprié.
Remarques
Inscrivez votre implémentation de cette fonction de rappel en définissant le membre approprié de HWN_CLIENT_REGISTRATION_PACKET, puis en appelant HwNRegisterClient.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1709 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| d’en-tête | hwnclx.h |
| IRQL | PASSIVE_LEVEL |