StorPortGetSystemAddress-Funktion (storport.h)

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