Freigeben über


StorPortGetStartIoPerfParams-Funktion (storport.h)

Die StorPortGetStartIoPerfParams-Routine platziert die Leistungsparameter für eine bestimmte E/A-Anforderung in einer STARTIO_PERFORMANCE_PARAMETERS-Struktur .

Syntax

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

Parameter

[in] HwDeviceExtension

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

[in] Srb

Der SRB-Zeiger, der an die vom Miniporttreiber bereitgestellte HwStorStartIo-Routine übergeben wurde. Dieser Parameter darf nicht NULL sein.

[in, out] StartIoPerfParams

Ein Zeiger auf eine STARTIO_PERFORMANCE_PARAMETERS Struktur, die der Miniporttreiber bereitstellt. Der Miniporttreiber muss nur die Größe der zugeordneten Struktur festlegen, da Storport die anderen Elemente festgibt. Dieser Parameter darf nicht NULL sein.

Rückgabewert

StorPortGetStartIoPerfParams gibt einen der folgenden status-Werte 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 Leistungsparameter in StartIoPerfParams gespeichert wurden.
STOR_STATUS_INVALID_PARAMETER
Entweder der Srb-Parameter oder der StartIoPerfParams-Parameter ist NULL.

Oder

Der HwDeviceExtension-Parameter ist NULL oder ungültig.

Oder

Der Srb-Parameter verweist nicht auf einen von Storport gesendeten SRB.

Oder

Die struktur, auf die von StartIoPerfParams verwiesen wird, ist ungültig, da der Wert des Size-Elements angibt, dass die Struktur zu klein ist, um die zurückgegebenen Daten zu enthalten.

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
Zielplattform Universell
Header storport.h (einschließlich Storport.h)

Weitere Informationen

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK