Partager via

Traitement des IIP WMI dans une routine DispatchSystemControl

  • Article

Un pilote qui gère les IRP WMI dans sa routine DispatchSystemControl ne doit gérer ce type d’IRP que si le pointeur de l’objet d’appareil à Parameters.WMI.ProviderId correspond au pointeur transmis par le pilote dans son appel à IoWMIRegistrationControl. Sinon, le pilote doit transférer l’IRP au pilote inférieur suivant.

Si le pilote gère la demande, il doit :

Vérifiez le GUID sur Parameters.WMI.DataPath pour déterminer s’il représente un bloc de données pris en charge par le pilote et, si ce n’est pas le cas, échouez l’IRP avec STATUS_WMI_GUID_NOT_FOUND.

Un pilote doit case activée la structure d’entrée WNODE_XXX sur Parameters.WMI.Buffer pour le nom instance lors de la gestion de l’une des demandes suivantes :

IRP_MN_QUERY_SINGLE_INSTANCEIRP_MN_CHANGE_SINGLE_INSTANCEIRP_MN_CHANGE_SINGLE_ITEMIRP_MN_EXECUTE_METHOD Le pilote doit case activée pour le nom de instance comme suit :

  • Si WNODE_FLAG_STATIC_INSTANCE_NAMES est défini dans WnodeHeader.Flags, utilisez InstanceIndex comme index dans la liste des noms de instance statiques du pilote pour ce bloc.

  • Si WNODE_FLAG_STATIC_INSTANCE_NAMES est clair dans WnodeHeader.Flags, utilisez OffsetInstanceName comme décalage vers la chaîne de nom instance dans la structure d’entrée WNODE_XXX. OffsetInstanceName est le décalage en octets entre le début de la structure et un USHORT qui indique la longueur de la chaîne de nom instance en octets (pas de caractères), y compris le point de terminaison NUL le cas échéant, suivi de la chaîne elle-même en Unicode.

Si le pilote ne peut pas localiser le instance spécifié par InstanceIndex ou OffsetInstanceName, il doit échouer l’IRP avec STATUS_WMI_INSTANCE_NOT_FOUND.

Pour une demande de IRP_MN_EXECUTE_METHOD, case activée MethodID dans le WNODE_METHOD_ITEM d’entrée et, si la méthode n’est pas valide pour ce bloc de données, échouez l’IRP avec STATUS_WMI_ITEMID_NOT_FOUND.

Si la requête génère une sortie, un pilote doit case activée la taille de la mémoire tampon sur Parameters.WMI.BufferSize lors de la gestion de l’une des demandes suivantes :

IRP_MN_QUERY_ALL_DATAIRP_MN_QUERY_SINGLE_INSTANCEIRP_MN_EXECUTE_METHOD Si la mémoire tampon est trop petite pour recevoir la sortie, mais au moins sizeof(WNODE_TOO_SMALL), le pilote doit réussir l’IRP et écrire une structure WNODE_TOO_SMALL dans la mémoire tampon sur Parameters.WMI.Buffer. Si la mémoire tampon est inférieure à sizeof(WNODE_TOO_SMALL), le pilote échoue à l’IRP avec un code NTSTATUS de STATUS_BUFFER_TOO_SMALL.

Si la requête génère une sortie et que la taille de la mémoire tampon est suffisante, écrivez la sortie suivante dans la mémoire tampon à l’adresse Parameters.WMI.Buffer :

  • Pour une requête de IRP_MN_QUERY_ALL_DATA , le pilote écrit une structure de WNODE_ALL_DATA qui contient des données pour toutes les instances du bloc de données spécifié.
  • Pour une demande de IRP_MN_QUERY_SINGLE_INSTANCE, le pilote écrit une structure de WNODE_SINGLE_INSTANCE qui contient des données pour le instance spécifié d’un bloc de données.
  • Pour une IRP_MN_EXECUTE_METHOD si la méthode génère une sortie, le pilote écrit la sortie de la méthode au format déterminé par le pilote en suivant l’entrée WNODE_METHOD_ITEM dans la mémoire tampon (en remplaçant les données d’entrée, le cas échéant).

Définissez Irp-IoStatus.Information> sur le nombre d’octets écrits dans la mémoire tampon sur Parameters.WMI.Buffer et Irp-IoStatus.Status> sur STATUS_SUCCESS.

Appelez IoCompleteRequest pour terminer l’IRP.

Pour plus d’informations, consultez WMI WNODE_XXX Structures.