Fonction ScsiPortWmiSetInstanceCount (scsiwmi.h)
ScsiPortWmiSetInstanceCount spécifie le nombre d’instances pour lesquelles les mémoires tampons de données doivent être mises de côté dans la structure WNODE_ALL_DATA dans le contexte de la requête.
Syntaxe
BOOLEAN ScsiPortWmiSetInstanceCount(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
[in] ULONG InstanceCount,
[out] PULONG BufferAvail,
[out] PULONG SizeNeeded
);
Paramètres
[in] RequestContext
Pointeur vers une structure de type SCSIWMI_REQUEST_CONTEXT qui contient le contexte de requête pour un SRB WMI.
[in] InstanceCount
Contient le nombre d’instances pour lesquelles le minidriver fournira des données.
[out] BufferAvail
Contient, au retour, le nombre d’octets d’espace tampon disponible pour décrire les noms et les données instance. La valeur retournée dans ce membre peut être passée aux routines ScsiPortWmiSetData et ScsiPortWmiSetInstanceName dans le paramètre BufferAvail de ces routines.
La routine ScsiPortWmiSetInstanceCount initialise un tableau de pointeurs vers des mémoires tampons de données, avec un élément de tableau pour chaque instance. S’il n’y a pas suffisamment de mémoire disponible dans le WNODE pour initialiser un tableau de taille InstanceCount, un zéro est retourné dans ce membre.
[out] SizeNeeded
Indique, lors de l’entrée, le nombre d’octets nécessaires pour décrire l’intégralité du WNODE avant de configurer les tableaux internes dans le WNODE. Au retour, ce membre contiendra la taille de l’ensemble du WNODE, y compris les tableaux nouvellement initialisés dans le WNODE.
Valeur retournée
La routine ScsiPortWmiSetInstanceCount retourne TRUE si l’opération réussit et FALSE si le WNODE contenu dans le contexte de requête n’est pas de type WNODE_ALL_DATA.
Remarques
Le minidriver doit appeler ScsiPortWmiSetInstanceCount avant d’appeler ScsiPortWmiSetData ou ScsiPortWmiSetInstanceName. Le minidriver ne doit appeler ScsiPortWmiSetInstanceCount qu’une seule fois.
Le paramètre RequestContext pointe vers une structure de contexte de requête, SCSIWMI_REQUEST_CONTEXT, qui contient des informations associées à un bloc de requête SCSI (SRB) WMI (Windows Management Instrumentation ). La structure de contexte de la demande, à son tour, contient l’une des structures de WNODE_XXX WMI utilisées par le système WMI pour transmettre des données entre les consommateurs de données en mode utilisateur et les fournisseurs de données en mode noyau, tels que les pilotes.
La routine ScsiPortWmiSetInstanceCount nécessite que la structure WNODE définie dans le contexte de la requête soit de type WNODE_ALL_DATA. En effet , ScsiPortWmiSetInstanceCount met de côté une zone de données qui contiendra des informations pour plusieurs instances associées à un bloc de données WMI. Contrairement à la structure WNODE_SINGLE_INSTANCE qui contient des informations sur un seul instance, la structure WNODE_ALL_DATA contient un tableau de pointeurs vers des zones de mémoire tampon pour différentes instances, et ScsiPortWmiSetInstanceCount initialise ce tableau, afin que chaque mémoire tampon de données instance soit accessible individuellement à l’aide d’un index instance.
La mémoire allouée pour le contexte de requête doit rester valide jusqu’à ce que le pilote miniport appelle ScsiPortWmiPostProcess, et ScsiPortWmiPostProcess retourne la status SRB finale et la taille de la mémoire tampon. Si le SRB peut être suspendu, la mémoire du contexte de requête doit être allouée à partir de l’extension SRB. Si le SRB ne peut pas être suspendu, la mémoire peut être allouée à partir d’un frame de pile qui ne sort pas de l’étendue.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | scsiwmi.h (inclure Miniport.h, Scsi.h) |