Condividi tramite


Funzione ScsiPortWmiSetInstanceName (scsiwmi.h)

La routine ScsiPortWmiSetInstanceName aggiorna la struttura WNODE_ALL_DATA all'interno del contesto della richiesta per specificare la posizione e la lunghezza di un nome di istanza.

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

Sintassi

PWCHAR ScsiPortWmiSetInstanceName(
  [in]      PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [in]      ULONG                    InstanceIndex,
  [in]      ULONG                    InstanceNameLength,
  [out]     PULONG                   BufferAvail,
  [in, out] PULONG                   SizeNeeded
);

Parametri

[in] RequestContext

Puntatore a una struttura di tipo SCSIWMI_REQUEST_CONTEXT che contiene il contesto della richiesta per un SRB WMI.

[in] InstanceIndex

Contiene un indice che indica l'istanza per cui specificare la posizione e la lunghezza del nome dell'istanza.

[in] InstanceNameLength

Specifica le dimensioni in byte del nome dell'istanza.

[out] BufferAvail

Deve contenere, all'input, il numero di byte di spazio buffer nella struttura WNODE_ALL_DATA che può essere usata per descrivere i nomi e i dati delle istanze. In caso di restituzione, questo membro contiene il numero di byte di spazio buffer che rimangono.

Esistono tre routine WMI della porta SCSI che restituiscono un valore per le dimensioni del buffer disponibili nel parametro BufferAvail :

ScsiPortWmiSetInstanceCount

ScsiPortWmiSetData

ScsiPortWmiSetInstanceName

Il driver miniport deve chiamare prima ScsiPortWmiSetInstanceCount, ma dopo ScsiPortWmiSetInstanceCount è stato chiamato, non importa in quale ordine il minidriver chiama ScsiPortWmiSetData e ScsiPortWmiSetInstanceName. Quando si chiama ScsiPortWmiSetData o ScsiPortWmiSetInstanceName, il valore passato alla routine nel parametro BufferAvail deve corrispondere al valore restituito nel parametro BufferAvail dalla routine WMI della porta SCSI più di recente. Si supponga, ad esempio, che il minidriver chiami prima ScsiPortWmiSetInstanceCount e questa routine restituisca un valore pari a 1.000 nel parametro BufferAvail . Il minidriver chiama quindi ScsiPortWmiSetData che restituisce un valore pari a 500 nel parametro BufferAvail . Infine, il minidriver chiama ScsiPortWmiSetInstanceName che restituisce un valore pari a 200 nel parametro BufferAvail . Il valore iniziale di 1.000 deve essere passato a ScsiPortWmiSetData in BufferAvaile il valore di 500 deve essere passato a ScsiPortWmiSetInstanceName.

Se non è disponibile memoria sufficiente per aggiungere un nome di istanza di lunghezza InstanceNameLength, verrà restituito uno zero nel membro BufferAvail.

[in, out] SizeNeeded

Indica, all'input, il numero di byte necessari per descrivere il WNODE prima di aggiungere i dati descrittivi per l'istanza specificata da InstanceIndex. In caso di restituzione, questo membro conterrà le dimensioni dell'intero WNODE, inclusi i dati per la nuova istanza.

Valore restituito

La routine ScsiPortWmiSetInstanceCount restituisce un puntatore al buffer in cui il chiamante può archiviare il nome dell'istanza specificata in InstanceIndex. Se ScsiPortWmiSetInstanceCount non è in grado di allocare memoria sufficiente per il nome dell'istanza o se WNODE contenuto nel contesto della richiesta non è di tipo WNODE_ALL_DATA, ScsiPortWmiSetData restituisce NULL.

Osservazioni

Il minidriver deve chiamare ScsiPortWmiSetInstanceCount prima di chiamare ScsiPortWmiSetInstanceName.

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 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 routine ScsiPortWmiSetInstanceName richiede che la struttura WNODE definita all'interno del contesto della richiesta sia di tipo WNODE_ALL_DATA. Questo perché ScsiPortWmiSetInstanceName può riservare un'area del nome dell'istanza per qualsiasi istanza associata a un blocco di dati WMI. A differenza della struttura WNODE_SINGLE_INSTANCE che contiene informazioni su una singola istanza, la struttura WNODE_ALL_DATA contiene una matrice di puntatori alle aree di buffer per istanze diverse e ScsiPortWmiSetInstanceCount inizializza questa matrice, in modo che ogni buffer di dati dell'istanza sia accessibile singolarmente.

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)

Vedere anche

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE