EVT_WDF_WMI_INSTANCE_SET_INSTANCE fonction de rappel (wdfwmi.h)

[S’applique uniquement à KMDF]

La fonction de rappel EvtWmiInstanceSetInstance d’un pilote définit toutes les données d’instance d’un fournisseur de données WMI sur les valeurs qu’un client WMI fournit.

Syntaxe

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

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

Paramètres

[in] WmiInstance

Handle vers un objet d’instance WMI.

[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 EvtWmiInstanceSetInstance doit retourner STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) est égal à FALSE. Si la mémoire tampon d’entrée vers laquelle pointe le paramètre InBuffer 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 EvtWmiInstanceSetInstance , 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 les données d’une fonction de rappel EvtWmiInstanceSetInstance sont dynamiques et partagées avec d’autres fonctions de rappel, votre pilote peut utiliser les verrous d’attente ou les verrous de rotation de l’infrastructure pour synchroniser l’accès aux données.

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

Configuration requise

   
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfwmi.h (inclure Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate