StorPortGetScatterGatherList-Funktion (storport.h)

Artikel
02/26/2024

Die StorPortGetScatterGatherList-Routine ruft die zugeordnete Scatter/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. Hierbei handelt es sich um einen HBA-Speicherbereich, den der Porttreiber im Auftrag des Miniporttreibers ordnet und initialisiert. Miniporttreiber speichern normalerweise HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand des HBA und die zugeordneten Zugriffsbereiche für den HBA. Dieser Bereich steht dem Miniport unmittelbar nach dem Aufruf des Miniporttreibers StorPortInitialize zur Verfügung. Der Porttreiber gibt diesen Arbeitsspeicher frei, wenn er das Gerät entfernt.

[in] Srb

Zeiger auf den SRB, für den die Punktsammlungsliste erstellt werden soll.

Rückgabewert

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

Hinweise

Diese Routine wird mit der Storport-Treiberbibliothek bereitgestellt. In der SCSI-Portbibliothek wird keine parallele Routine bereitgestellt.

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

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

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

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.