WMI_SET_DATABLOCK_CALLBACK fonction de rappel (wmilib.h)

Article
02/07/2025

Le DpWmiSetDataBlock routine modifie tous les éléments de données dans une seule instance d’un bloc de données. Cette routine est facultative.

Syntaxe

WMI_SET_DATABLOCK_CALLBACK WmiSetDatablockCallback;

NTSTATUS WmiSetDatablockCallback(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP Irp,
  [in] ULONG GuidIndex,
  [in] ULONG InstanceIndex,
  [in] ULONG BufferSize,
  [in] PUCHAR Buffer
)
{...}

Paramètres

[in] DeviceObject

Pointeur vers la structure de DEVICE_OBJECT WDM du pilote.

[in] Irp

Pointeur vers l’IRP.

[in] GuidIndex

Spécifie le bloc de données par son index de base zéro dans la liste des GUID fournis par le pilote dans la structure WMILIB_CONTEXT qu’il a passée à WmiSystemControl.

[in] InstanceIndex

Si le bloc spécifié par GuidIndex a plusieurs instances, InstanceIndex spécifie l’instance.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon à tampon.

[in] Buffer

Pointeur vers une mémoire tampon qui contient de nouvelles valeurs pour l’instance.

Valeur de retour

DpWmiSetDataBlock retourne STATUS_SUCCESS ou un état d’erreur approprié, par exemple :

Si le pilote ne peut pas terminer la requête immédiatement, il peut retourner STATUS_PENDING.

Remarques

WMI appelle la routine DpWmiSetDataBlock d’un pilote après que le pilote appelle WmiSystemControl en réponse à une demande de IRP_MN_CHANGE_SINGLE_INSTANCE.

Le pilote est chargé de valider tous les arguments d’entrée. Plus précisément, le pilote doit effectuer les opérations suivantes :

Vérifiez que la valeur GuidIndex est comprise entre zéro et GuidCount-1, en fonction du membre GuidCount de la structure WMILIB_CONTEXT.
Vérifiez que le pilote n’a pas marqué le bloc de données spécifié pour la suppression. Si le pilote a récemment spécifié l’indicateur de WMIREG_FLAG_REMOVE_GUID dans un WMIGUIDREGINFO structure contenue dans une structure WMILIB_CONTEXT, il est possible qu’une demande définie arrive avant la suppression.
Vérifiez que la valeur InstanceIndex se trouve dans la plage d’index d’instance pris en charge par le pilote pour le bloc de données.
Vérifiez que tampon et BufferSize décrivent un bloc de données de taille valide, y compris tout remplissage existant entre les éléments de données et que le contenu de la mémoire tampon est valide pour le bloc de données.
Vérifiez que le bloc de données spécifié est un pour lequel le pilote autorise les modifications initiées par l’appelant. En d’autres termes, le pilote ne doit pas autoriser les modifications apportées aux blocs de données que vous souhaitiez être en lecture seule.

Ne partez pas du principe que le contexte de thread est celui de l’application en mode utilisateur initial, un pilote de niveau supérieur peut l’avoir modifié.

Si un pilote implémente une routine DpWmiSetDataBlock, le pilote doit placer l’adresse de la routine dans le membre SetWmiDataBlock de la structure WMILIB_CONTEXT qu’elle passe à WmiSystemControl. Si un pilote n’implémente pas de routine DpWmiSetDataBlock, il doit définir SetWmiDataBlock sur NULL. Dans ce dernier cas, WMI retourne STATUS_READ_ONLY à l’appelant.

Cette routine peut être paginable.

Pour plus d’informations sur l’implémentation de cette routine, consultez Appel de WmiSystemControl pour gérer les runtimes d’intégration WMI.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	wmilib.h (include Wmilib.h)
IRQL	Appelé à PASSIVE_LEVEL.

Voir aussi

IRP_MN_CHANGE_SINGLE_INSTANCE

WMILIB_CONTEXT

WmiSystemControl

Partager via