Partager via


HWN_CLIENT_SET_STATE fonction de rappel (hwnclx.h)

Implémenté par le pilote client pour définir l’état du composant de notification matérielle. Il est appelé 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 du framework par WdfDeviceCreate. Pour plus d’informations, consultez HWN_CLIENT_REGISTRATION_PACKET et Framework Object Context Space.

[in] Buffer

Mémoire tampon d’octets BufferLength contenant une structure HWN_HEADER comprenant une ou plusieurs structures HWN_SETTINGS qui spécifient les notifications matérielles à définir.

[in] BufferLength

Taille de la mémoire tampon en octets.

[out] BytesWritten

Pointeur vers une variable qui indique le nombre d’octets écrits par la fonction.

Valeur retournée

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête hwnclx.h
IRQL PASSIVE_LEVEL

Voir aussi

Prise en charge des notifications matérielles

Informations de référence sur les notifications matérielles