Fonction ScsiPortWmiGetInstanceName (scsiwmi.h)
La routine ScsiPortWmiGetInstanceName retourne un pointeur vers le nom de l’instance associé au Windows Management Instrumentation (WMI) SCSI Request Block (SRB).
Syntaxe
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
Paramètres
[in] RequestContext
Pointeur vers une structure de type SCSIWMI_REQUEST_CONTEXT qui contient le contexte de requête d’un SRB WMI.
Valeur de retour
Pointeur vers une chaîne comptée contenant le nom d’instance associé au SRB indiqué. Si le type SRB n’utilise pas de nom d’instance, ScsiPortWmiGetInstanceName retourne NULL.
Remarques
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êtes SCSI Windows Management Instrumentation (WMI). La structure de contexte de requête contient à son tour l’une des WMI WNODE_XXX Structures utilisée 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 structure WNODE_XXX contenue dans le contexte de requête contient un nom d’instance associé au SRB WMI. Le pilote miniport appelle ScsiPortWmiGetInstanceName pour extraire ce nom d’instance du contexte de requête.
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 l’état SRB final 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’une trame de pile qui ne dépasse pas l’étendue.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | scsiwmi.h (include Miniport.h, Scsi.h) |