StorPortGetScatterGatherList-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortGetScatterGatherList Routine ruft die zugeordnete Punkt/Gather-Liste für den angegebenen SCSI-Anforderungsblock (SRB) ab.

Syntax

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

Parameter

[in] HwDeviceExtension

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

[in] Srb

Zeiger auf den SRB, für den die Punkt-Sammelliste erstellt werden soll.

Rückgabewert

StorPortGetScatterGatherList- gibt einen Zeiger auf die Punkt/Gather-Liste zurück.

Bemerkungen

Diese Routine wird mit der Storport-Treiberbibliothek bereitgestellt. Es gibt keine parallele Routine in der SCSI-Portbibliothek.

Der Zeiger auf die zurückgegebene Punkt-/Gather-Liste ist nur gültig, bis der SRB abgeschlossen ist.

Der Miniporttreiber muss den Speicher für die Punkt/Gather-Liste nicht freigeben, die StorPortGetScatterGatherList zurückgibt.

Der Miniporttreiber darf die Punkt/Gather-Liste nicht ändern.

Ab Windows 8 kann der parameter Srb entweder auf SCSI_REQUEST_BLOCK oder STORAGE_REQUEST_BLOCKverweisen. Wenn der Funktionsbezeichner im Feld Function von SrbSRB_FUNCTION_STORAGE_REQUEST_BLOCKist, ist der SRB eine STORAGE_REQUEST_BLOCK Anforderungsstruktur.