Funzione ScsiPortWmiGetInstanceName (scsiwmi.h)
La routine ScsiPortWmiGetInstanceName restituisce un puntatore al nome dell'istanza associato all'oggetto indicato blocco di richieste SCSI (WMI) di Strumentazione gestione Windows (WMI).
Sintassi
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
Parametri
[in] RequestContext
Puntatore a una struttura di tipo SCSIWMI_REQUEST_CONTEXT che contiene il contesto della richiesta per un SRB WMI.
Valore restituito
Puntatore a una stringa con conteggiata contenente il nome dell'istanza associato all'SRB indicato. Se il tipo SRB è uno che non usa un nome di istanza, ScsiPortWmiGetInstanceName restituisce NULL.
Osservazioni
Il parametro RequestContext punta a una struttura del contesto della richiesta, SCSIWMI_REQUEST_CONTEXT, che contiene informazioni associate a un blocco di richieste SCSI (WMI) di Strumentazione gestione Windows (WMI). La struttura del contesto della richiesta, a sua volta, contiene una delle strutture WMI WNODE_XXX strutture usate dal sistema WMI per passare dati tra consumer di dati in modalità utente e provider di dati in modalità kernel, ad esempio driver.
La struttura WNODE_XXX contenuta nel contesto della richiesta contiene un nome di istanza associato a WMI SRB. Il driver miniport chiama ScsiPortWmiGetInstanceName per estrarre questo nome di istanza dal contesto della richiesta.
La memoria allocata per il contesto della richiesta deve rimanere valida fino a quando il driver miniport chiama ScsiPortWmiPostProcesse ScsiPortWmiPostProcess restituisce lo stato ERB finale e le dimensioni del buffer. Se SRB può eseguire la penna, la memoria per il contesto della richiesta deve essere allocata dall'estensione SRB. Se SRB non può eseguire la penna, la memoria può essere allocata da un frame dello stack che non esce dall'ambito.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | scsiwmi.h (include Miniport.h, Scsi.h) |