Fonction ScsiPortWmiGetInstanceName (scsiwmi.h)
La routine SCSIPortWmiGetInstanceName retourne un pointeur vers le nom instance associé à l’indiqué le bloc de requête SCSI (SRB) WMI (Windows Management Instrumentation).
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 demande pour un SRB WMI.
Valeur retournée
Pointeur vers une chaîne comptée contenant le nom instance associé au SRB indiqué. Si le type SRB n’utilise pas de nom 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ête SCSI (SRB) WMI (Windows Management Instrumentation ). La structure de contexte de requête, à 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 structure WNODE_XXX contenue dans le contexte de requête contient un nom de instance associé au SRB WMI. Le pilote miniport appelle ScsiPortWmiGetInstanceName pour extraire ce nom 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 ait appelé ScsiPortWmiPostProcess, et que ScsiPortWmiPostProcess retourne la status SRB finale et la taille de 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 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) |