Funzione StorPortGetSystemAddress (storport.h)

Articolo
02/07/2025

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 la scheda 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	Tentativo di eseguire il mapping del buffer di dati allo spazio di sistema non riuscito.

Osservazioni

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

Fabbisogno

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)

Vedere anche

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

Condividi tramite