Funzione StorPortGetStartIoPerfParams (storport.h)

Articolo
02/29/2024

La routine StorPortGetStartIoPerfParams inserisce i parametri delle prestazioni per una determinata richiesta di I/O in una struttura di STARTIO_PERFORMANCE_PARAMETERS .

Sintassi

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

[in] Srb

Puntatore SRB passato alla routine HwStorStartIo fornita dal driver miniport. Questo parametro non deve essere NULL.

[in, out] StartIoPerfParams

Puntatore a una struttura STARTIO_PERFORMANCE_PARAMETERS fornita dal driver miniport. Il driver miniport deve impostare solo le dimensioni della struttura allocata, poiché Storport imposta gli altri membri. Questo parametro non deve essere NULL.

Valore restituito

StorPortGetStartIoPerfParams 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 i parametri delle prestazioni sono stati archiviati in StartIoPerfParams.
STOR_STATUS_INVALID_PARAMETER	Il parametro Srb o il parametro StartIoPerfParams è NULL. -oppure- Il parametro HwDeviceExtension è NULL o non valido. -oppure- Il parametro Srb non punta a una SRB inviata da Storport -oppure- La struttura a cui punta StartIoPerfParams non è valida perché il valore del membro Size indica che la struttura è troppo piccola per contenere i dati restituiti.

Codice restituito

Descrizione

STOR_STATUS_NOT_IMPLEMENTED

Questa funzione non viene implementata nel sistema operativo attivo.

STOR_STATUS_SUCCESS

Indica che i parametri delle prestazioni sono stati archiviati in StartIoPerfParams.

STOR_STATUS_INVALID_PARAMETER

Il parametro Srb o il parametro StartIoPerfParams è NULL.

-oppure-

Il parametro HwDeviceExtension è NULL o non valido.

-oppure-

Il parametro Srb non punta a una SRB inviata da Storport

-oppure-

La struttura a cui punta StartIoPerfParams non è valida perché il valore del membro Size indica che la struttura è troppo piccola per contenere i dati restituiti.

Commenti

A partire da Windows 8, il parametro Srb può puntare a SCSI_REQUEST_BLOCK o STORAGE_REQUEST_BLOCK. Se l'identificatore di funzione nel campo Funzione di Srb è SRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB è una struttura di richiesta STORAGE_REQUEST_BLOCK .