Funzione ScsiPortWmiGetInstanceName (scsiwmi.h)

  • Articolo

La routine ScsiPortWmiGetInstanceName restituisce un puntatore al nome dell'istanza associato all'oggetto indicato il blocco di richieste SCSI (WMI) di Strumentazione gestione Windows ( SRB).

Nota I modelli di driver di porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare il driver Storport e i modelli di driver miniport Storport .
 

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'oggetto SRB indicato. Se il tipo SRB è uno che non usa un nome di istanza, ScsiPortWmiGetInstanceName restituisce NULL.

Commenti

Il parametro RequestContext punta a una struttura del contesto di 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 utilizzate dal sistema WMI per passare i dati tra consumer di dati in modalità utente e provider di dati in modalità kernel, ad esempio i driver.

La struttura WNODE_XXX contenuta nel contesto della richiesta contiene un nome di istanza associato all'SRB WMI. Il driver miniport chiama ScsiPortWmiGetInstanceName per estrarre il nome dell'istanza dal contesto della richiesta.

La memoria allocata per il contesto della richiesta deve rimanere valida fino a quando il driver miniport chiama ScsiPortWmiPostProcess e 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 non è possibile eseguire la penna di SRB, la memoria può essere allocata da un frame dello stack che non esce dall'ambito.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione scsiwmi.h (include Miniport.h, Scsi.h)

Vedi anche

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE