StorPortInitializeWorker-Funktion (storport.h)

Erstellt eine neue Storport-Arbeitsaufgabe, die 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 Hostbusadapter (HBA).

[out] Worker

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

Rückgabewert

Die StorPortInitializeWorker Routine gibt einen der folgenden Statuscodes 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	Unzureichende Ressourcen sind verfügbar, um den Arbeitsaufgabenkontext zu initialisieren.
STOR_STATUS_SUCCESS	Die Arbeitsaufgabe wurde erfolgreich initialisiert.

Bemerkungen

Der arbeitsaufgabenkontext, der im parameter Worker von StorPortInitializeWorker zurückgegeben wird, wird in zukünftigen Aufrufen von StorPortQueueWorkItem oder StorPortFreeWorkerverwendet.

Wenn der Miniport die Arbeitsaufgabe während der E/A-Verarbeitung verwendet, wird empfohlen, dass StorPortInitialize Worker während der HwStorFindAdapter--Funktion aufgerufen werden, um sicherzustellen, dass Ressourcen bei Bedarf verfügbar sind.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 8 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem-