StorPortGetSystemAddress-Funktion (storport.h)

  • Artikel

Die StorPortGetSystemAddress-Routine gibt eine virtuelle Adresse im Systembereich für den Datenpuffer des angegebenen SCSI-Anforderungsblocks (SRB) zurück.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).

[in] Srb

Ein Zeiger auf eine SCSI_REQUEST_BLOCK-Struktur .

[out] SystemAddress

Ein Zeiger zum Empfangen der virtuellen Adresse des Datenpuffers.

Rückgabewert

StorPortGetSystemAddress gibt einen der folgenden status-Codes zurück:

Rückgabecode Beschreibung
STOR_STATUS_NOT_IMPLEMENTED
 Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STOR_STATUS_SUCCESS
 Gibt an, dass die Systemadresse erfolgreich abgerufen wurde.
STOR_STATUS_INVALID_PARAMETER
 Dieser status Code wird durch eine der folgenden Bedingungen verursacht:

Der SRB verfügt nicht über einen zugeordneten Datenpuffer.

Der Zeiger zum Empfangen der virtuellen Adresse ist NULL.
STOR_STATUS_INVALID_IRQL
 Der Aufruf wurde an einem ungültigen IRQL ausgeführt.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Beim Versuch, den Datenpuffer dem Systemspeicher zuzuordnen, ist ein Fehler aufgetreten.

Hinweise

Ab Windows 8 kann der Srb-Parameter entweder auf SCSI_REQUEST_BLOCK oder STORAGE_REQUEST_BLOCK verweisen. Wenn der Funktionsbezeichner im Feld Funktion von SrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK ist, ist der SRB eine STORAGE_REQUEST_BLOCK Anforderungsstruktur.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Diese Routine ist ab Windows Server 2003 mit SP2 verfügbar.
Zielplattform Universell
Header storport.h (einschließlich Storport.h)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln StorPortIrql(storport)

Weitere Informationen

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK