StorPortNvmeIceIoStart-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortNvmeIceIoStart-Funktion initiiert einen NVMe ICE-Vorgang (sofortiges kryptografisches Löschen) der E/A-Operation.

Syntax

ULONG StorPortNvmeIceIoStart(
  PVOID               HwDeviceExtension,
  PSCSI_REQUEST_BLOCK Srb,
  ULONG               LbaCount,
  ULONG               PrpCount,
  PULONGLONG          Prp1,
  PULONGLONG          Prp2,
  PULONGLONG          PrpList
);

Parameter

HwDeviceExtension

[in] Ein Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein Kontextbereich pro HBA (Host Bus Adapter), der vom Miniporttreiber bereitgestellt wird. Der Miniporttreiber kann hier HBA-spezifische Informationen speichern.

Srb

[in] Ein Zeiger auf einen SCSI-Anforderungsblock. Diese Struktur stellt eine einzelne E/A-Anforderung dar.

LbaCount

[in] Die Anzahl der zu übertragenden logischen Blockadressen (LBAs).

PrpCount

[in] Die Anzahl der zu übertragenden physischen Regionsseiten (PRPs).

Prp1

[in/out] Ein Zeiger auf den ersten PRP, der in NVMe verwendet wird, um die physischen Speicherspeicherorte zu beschreiben, die an der Datenübertragung beteiligt sind.

Prp2

[in/out] Ein Zeiger auf den zweiten PRP, der in NVMe verwendet wird, um die physischen Speicherspeicherorte zu beschreiben, die an der Datenübertragung beteiligt sind.

PrpList

[in/out] Ein Zeiger auf eine Liste zusätzlicher PRPs.

Rückgabewert

StorPortNvmeIceIoStart gibt STOR_STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein STOR_STATUS Wert zurückgegeben, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_INVALID_PARAMETER	Einer der Parameter ist ungültig.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11
Header-	storport.h

Siehe auch

StorPortNvmeIceIoComplete

Freigeben über