Funzione StorPortGetSystemAddress (storport.h)

  • Articolo

La routine StorPortGetSystemAddress restituisce un indirizzo virtuale nello spazio di sistema per il buffer di dati del blocco di richiesta SCSI specificato.

Sintassi

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Parametri

[in] HwDeviceExtension

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

[in] Srb

Puntatore a una struttura SCSI_REQUEST_BLOCK .

[out] SystemAddress

Puntatore per ricevere l'indirizzo virtuale del buffer di dati.

Valore restituito

StorPortGetSystemAddress restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_NOT_IMPLEMENTED
 Questa funzione non viene implementata nel sistema operativo attivo.
STOR_STATUS_SUCCESS
 Indica che l'indirizzo di sistema è stato ottenuto correttamente.
STOR_STATUS_INVALID_PARAMETER
 Questo codice di stato è causato da una delle condizioni seguenti:

SRB non dispone di un buffer di dati associato.

Il puntatore per ricevere l'indirizzo virtuale è NULL.
STOR_STATUS_INVALID_IRQL
 La chiamata è stata effettuata in un IRQL non valido.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Il tentativo di eseguire il mapping del buffer dei dati allo spazio di sistema non è riuscito.

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 .

Requisiti

Requisito Valore
Client minimo supportato Questa routine è disponibile a partire da Windows Server 2003 con SP2.
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI StorPortIrql(storport)

Vedi anche

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK