Freigeben über


StorPortInitializeWorker-Funktion (storport.h)

Erstellt ein neues Storport-Arbeitselement, das in einem Systemarbeitsthread ausgeführt wird.

Syntax

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Parameter

[in] HwDeviceExtension

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

[out] Worker

Ein Zeiger auf einen undurchsichtigen Puffer, der Kontextinformationen für das Arbeitselement enthält.

Rückgabewert

Die StorPortInitializeWorker-Routine gibt einen der folgenden status Codes zurück:

Rückgabecode Beschreibung
STOR_STATUS_INVALID_IRQL
Aktuelle IRQL-> DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER
Entweder HwDeviceExtension oder Worker ist NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
Für die Initialisierung des Arbeitselementkontexts sind unzureichende Ressourcen verfügbar.
STOR_STATUS_SUCCESS
Das Arbeitselement wurde erfolgreich initialisiert.

Hinweise

Der im Worker-Parameter von StorPortInitializeWorker zurückgegebene Arbeitselementkontext wird in zukünftigen Aufrufen von StorPortQueueWorkItem oder StorPortFreeWorker verwendet.

Wenn der Miniport das Arbeitselement während der E/A-Verarbeitung verwendet, wird empfohlen, StorPortInitializeWorker während der HwStorFindAdapter-Funktion des Miniports zu aufrufen, um sicherzustellen, dass ressourcen bei Bedarf verfügbar sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 8 und höheren Versionen von Windows.
Zielplattform Universell
Header storport.h (Storport.h einschließen)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem