Funzione StorPortInitializePerfOpts (storport.h)

  • Articolo

La funzione StorPortInitializePerfOpts inizializza le ottimizzazioni delle prestazioni supportate sia dal driver miniport che dal driver Storport usando una struttura PERF_CONFIGURATION_DATA .

Sintassi

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA). Questo parametro non deve essere NULL.

[in] Query

Se impostato su TRUE, Storport imposta i flag in PerfConfigData corrispondenti alle ottimizzazioni supportate da Storport. Se impostato su FALSE, Storport inizializzerà le ottimizzazioni specificate dai flag in PerfConfigData.

[in, out] PerfConfigData

Puntatore a una struttura PERF_CONFIGURATION_DATA fornita dal conducente miniport. Questo parametro non deve essere NULL.

Valore restituito

StorPortInitializePerfOpts restituisce uno dei valori di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_NOT_IMPLEMENTED
 Questa funzione non viene implementata nel sistema operativo attivo.
STOR_STATUS_SUCCESS
 Indica che sono state applicate le impostazioni di ottimizzazione delle prestazioni.

Oppure se Query è impostata su TRUE, il membro Flags della struttura a cui punta per PerfConfigData contiene i flag supportati.
STOR_STATUS_UNSUCCESSFUL
 Il driver miniport imposta un flag in PerfConfigData che Storport non riconosce o il driver miniport ha chiamato questa routine dall'esterno della routine del miniport-driver fornito da HwStorInitialize routine.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Impossibile allocare strutture interne per supportare le ottimizzazioni richieste.
STOR_STATUS_INVALID_PARAMETER
 Il parametro HwDeviceExtension o il parametro PerfConfigData era NULL.

Commenti

Il driver miniport può chiamare StorPortInitializePerfOpts solo durante la routine HwStorInitialize fornita da miniport o la routine HwStorPassiveInitializeRoutine .

Le ottimizzazioni delle prestazioni disponibili dipendono dalla versione di PERF_CONFIGURATION_DATA. L'impostazione del membro Versione su STOR_PERF_VERSION consentirà di selezionare tutte le ottimizzazioni supportate.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)
Regole di conformità DDI StorPortPerfOpts(storport)

Vedi anche

PERF_CONFIGURATION_DATA