ScsiPortGetVirtualAddress-Funktion (srb.h)

Die ScsiPortGetVirtualAddress Routine gibt eine virtuelle Adresse zurück, die einer physischen Adresse zugeordnet ist, wenn die physische Adresse durch einen Aufruf von ScsiPortGetPhysicalAddressabgerufen wurde.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

Syntax

SCSIPORT_API PVOID ScsiPortGetVirtualAddress(
  [in] PVOID                 HwDeviceExtension,
  [in] SCSI_PHYSICAL_ADDRESS PhysicalAddress
);

Parameter

[in] HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein Speicherbereich pro HBA, den der Porttreiber im Namen des Miniporttreibers zuordnet und initialisiert. Miniporttreiber speichern in der Regel HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand der HBA und die zugeordneten Zugriffsbereiche der HBA. Dieser Bereich steht dem Miniporttreiber im DeviceExtension->HwDeviceExtension Mitglied des Geräteobjekts der HBA unmittelbar nach dem Aufruf ScsiPortInitializezur Verfügung. Der Porttreiber gibt diesen Speicher frei, wenn es das Gerät entfernt.

[in] PhysicalAddress

Gibt die physische Adresse an, die zugeordnet werden soll. Dieser Wert muss von ScsiPortGetPhysicalAddress zurückgegeben werden und muss aus einer nicht zwischengespeicherten Geräteerweiterung oder SRB-Erweiterung stammen.

Rückgabewert

ScsiPortGetVirtualAddress gibt einen zugeordneten Zeiger für die angegebene Eingabeadresse zurück. Wenn der wert PhysicalAddress ungültig ist, wird NULL-zurückgegeben.

Bemerkungen

ScsiPortGetVirtualAddress verwendetSCSI_PHYSICAL_ADDRESS, um physische Adressen darzustellen.

typedef PHYSICAL_ADDRESS SCSI_PHYSICAL_ADDRESS, *PSCSI_PHYSICAL_ADDRESS;

Der SCSI_PHYSICAL_ADDRESS Typ ist ein betriebssystemunabhängiger Datentyp, den SCSI-Miniporttreiber verwenden, um eine physische Adresse oder eine busrelative Adresse darzustellen.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	srb.h (include Miniport.h, Scsi.h)
Library	Scsiport.lib

Siehe auch

ScsiPortGetPhysicalAddress

ScsiPortGetUncachedExtension-