fonction de rappel EVT_WDF_WMI_INSTANCE_SET_ITEM (wdfwmi.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

Le EvtWmiInstanceSetItem d’un pilote fonction de rappel définit un élément unique des données d’instance d’un fournisseur de données WMI sur une valeur qu’un client WMI fournit.

Syntaxe

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

NTSTATUS EvtWdfWmiInstanceSetItem(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG DataItemId,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

Paramètres

[in] WmiInstance

Handle vers un objet d’instance WMI.

[in] DataItemId

Valeur qui identifie un élément de données pour une instance de fournisseur. Cette valeur correspond à la valeur WmiDataId spécifiée dans le fichier MOF du fournisseur.

[in] InBufferSize

Taille, en octets, de la mémoire tampon d’entrée vers laquelle InBuffer pointe.

[in] InBuffer

Pointeur vers la mémoire tampon d’entrée.

Valeur de retour

La fonction de rappel EvtWmiInstanceSetItem doit retourner STATUS_SUCCESS si l’opération réussit. Dans le cas contraire, cette fonction doit retourner une valeur d’état pour laquelle NT_SUCCESS(état) est égal à FALSE. Si la mémoire tampon d’entrée à laquelle la InBuffer points de paramètre est trop petite pour contenir toutes les données attendues par le pilote, la fonction de rappel doit retourner STATUS_WMI_SET_FAILURE.

Remarques

Pour inscrire une fonction de rappel EvtWmiInstanceSetItem, votre pilote doit placer l’adresse de la fonction dans une structure WDF_WMI_INSTANCE_CONFIG avant d’appeler WdfWmiInstanceCreate.

L’infrastructure ne synchronise pas les appels aux fonctions de rappel d’événements WMI d’un pilote entre elles ou avec l’une des autres fonctions de rappel d’événements du pilote. Si une EvtWmiInstanceSetItem données de la fonction de rappel est dynamique et partagée avec d’autres fonctions de rappel, votre pilote peut utiliser les verrous d’attente du framework ou les verrous de rotation pour synchroniser l’accès aux données.

Pour plus d’informations sur la fonction de rappel EvtWmiInstanceSetItem, consultez Prise en charge de WMI dans Framework-Based Drivers.