HWN_CLIENT_GET_STATE fonction de rappel (hwnclx.h)

Article
02/07/2025

Implémenté par le pilote client pour obtenir l’état du composant de notification matérielle. Elle est appelée lorsqu’un utilisateur demande des informations d’état.

Syntaxe

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

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.

[out] OutputBuffer

Mémoire tampon de OutputBufferLength octets pour écrire l’état de notification matérielle. Si la fonction réussit, la mémoire tampon contient une structure HWN_HEADER incluant une ou plusieurs structures HWN_SETTINGS.

note

OutputBufferLength doit être suffisamment volumineux pour contenir tous les paramètres demandés. Pour plus d’informations, consultez Remarques.

[in] OutputBufferLength

Taille de OutputBuffer en octets.

[in] InputBuffer

Mémoire tampon de InputBufferLength octets contenant un HWN_HEADER contenant une ou plusieurs structures HWN_SETTINGS où les ID des composants de notification matérielle demandés sont stockés dans le champ HwNId. Cette mémoire tampon peut être NULL.

[in] InputBufferLength

Taille de InputBuffer en octets.

[out] BytesRead

Pointeur vers une variable qui indique le nombre d’octets lus 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.

Si InputBuffer a la valeur NULL, la mémoire tampon de sortie est utilisée pour stocker une structure HWN_HEADER qui contient tous les paramètres des notifications matérielles implémentées par le pilote.
Les paramètres d’un composant de notification matérielle sont stockés dans une structure HWN_SETTINGS. Le champ HwNSettingsInfo de la structure HWN_HEADER contient un tableau de structures HWN_SETTINGS.
Si InputBuffer n’est pas null et qu’elle est correctement mise en forme, elle contient un HWN_HEADER avec une ou plusieurs structures HWN_SETTINGS. Les ID des composants de notification matérielle demandés sont stockés dans le champ HwNId de la structure HWN_SETTINGS. Les paramètres restants doivent être des paramètres valides ou zéro.
Si OutputBuffer n’est pas suffisamment volumineux pour contenir tous les paramètres demandés, cette fonction ne doit pas écrire quoi que ce soit dans OutputBuffer. En outre, il doit définir octetsRead sur 0 et retourner une erreur.

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

Voir aussi

notifications matérielles prennent en charge les

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

Partager via