Funzione SCSIPortWmiSetInstanceCount (SCSIwmi.h)

SCSIPortWmiSetInstanceCount specifica il numero di istanze per cui i buffer di dati devono essere messi a parte all'interno della struttura WNODE_ALL_DATA nel contesto della richiesta.

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

 

Sintassi

BOOLEAN ScsiPortWmiSetInstanceCount(
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [in]  ULONG                    InstanceCount,
  [out] PULONG                   BufferAvail,
  [out] PULONG                   SizeNeeded
);

Parametri

[in] RequestContext

Puntatore a una struttura di tipo SCSIWMI_REQUEST_CONTEXT contenente il contesto della richiesta per una SRB WMI.

[in] InstanceCount

Contiene il numero di istanze per cui il minidriver fornirà dati.

[out] BufferAvail

Contiene, in caso di restituzione, il numero di byte di spazio buffer disponibile per descrivere i nomi e i dati dell'istanza. Il valore restituito in questo membro può essere passato alle routine SCSIPortWmiSetData e SCSIPortWmiSetInstanceName nel parametro BufferAvail di tali routine.

La routine SCSIPortWmiSetInstanceCount inizializza una matrice di puntatori ai buffer di dati, con un elemento matrice per ogni istanza. Se non è disponibile memoria sufficiente nel WNODE per inizializzare una matrice di dimensioni InstanceCount, verrà restituito uno zero in questo membro.

[out] SizeNeeded

Indica, in input, il numero di byte necessari per descrivere l'intero WNODE prima di configurare le matrici interne nel WNODE. In caso di restituzione, questo membro conterrà le dimensioni dell'intero WNODE, incluse le matrici appena inizializzate all'interno di WNODE.

Valore restituito

La routine SCSIPortWmiSetInstanceCount restituisce TRUE se l'operazione ha esito positivo e FALSE se il WNODE contenuto nel contesto della richiesta non è di tipo WNODE_ALL_DATA.

Commenti

Il minidriver deve chiamare SCSIPortWmiSetInstanceCount prima di chiamare SCSIPortWmiSetData o SCSIPortWmiSetInstanceName. Il minidriver deve chiamare solo SCSIPortWmiSetInstanceCount una sola volta.

Il parametro RequestContext punta a una struttura di contesto di richiesta, SCSIWMI_REQUEST_CONTEXT, che contiene informazioni associate a un blocco di richiesta SCSI (WMI) di Strumentazione gestione Windows ( SRB). La struttura del contesto della richiesta, a sua volta, contiene una delle strutture WMI WNODE_XXX usate dal sistema WMI per passare i dati tra consumer di dati in modalità utente e provider di dati in modalità kernel, ad esempio driver.

La routine SCSIPortWmiSetInstanceCount richiede che la struttura WNODE definita all'interno del contesto della richiesta sia di tipo WNODE_ALL_DATA. Ciò avviene perché SCSIPortWmiSetInstanceCount imposta un'area dati che conterrà informazioni per più istanze associate 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 per aree di buffer per istanze diverse e SCSIPortWmiSetInstanceCount inizializza questa matrice, in modo che ogni buffer di dati dell'istanza possa essere accessibile singolarmente usando un indice di istanza.

La memoria allocata per il contesto di richiesta deve rimanere valida fino a quando il driver miniport chiama SCSIPortWmiPostProcess e SCSIPortWmiPostProcess restituisce lo stato E IL buffer finale. Se SRB può eseguire la penna, la memoria per il contesto della richiesta deve essere allocata dall'estensione SRB. Se SRB non è in grado di eseguire la penna, 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 (includere Miniport.h, SCSI.h)

Vedi anche

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE