HWN_CLIENT_GET_STATE fonction de rappel (hwnclx.h)

  • Article

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

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 une utilisation 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 Espace de contexte d’objetHWN_CLIENT_REGISTRATION_PACKET et framework.

[out] OutputBuffer

Mémoire tampon d’octets OutputBufferLength pour écrire des status de notification matérielle. Si la fonction réussit, la mémoire tampon contiendra une structure HWN_HEADER comprenant une ou plusieurs structures HWN_SETTINGS .

Remarque  

OutputBufferLength doit être suffisamment grand pour contenir tous les paramètres demandés. Pour plus d'informations, consultez la section Notes.

 

[in] OutputBufferLength

Taille de OutputBuffer en octets.

[in] InputBuffer

Mémoire tampon d’octets InputBufferLength 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 d’InputBuffer en octets.

[out] BytesRead

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

  • Si InputBuffer a la valeur NULL, la mémoire tampon de sortie sera 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 est correctement mis en forme, il 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 assez grand pour contenir tous les paramètres demandés, cette fonction ne doit rien écrire dans OutputBuffer. En outre, il doit définir BytesRead sur 0 et renvoyer une erreur.

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