StorPortQueueWorkItem-Funktion (storport.h)

Artikel
02/07/2025

StorPortQueueWorkItem eine Storport-Arbeitsaufgabe in die Warteschlange ein, die im Kontext eines Systemarbeitsthreads (Kernel) ausgeführt werden soll.

Syntax

ULONG StorPortQueueWorkItem(
  [in]           PVOID        HwDeviceExtension,
  [in]           PHW_WORKITEM WorkItemCallback,
  [in]           PVOID        Worker,
  [in, optional] PVOID        Context
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

[in] WorkItemCallback

Ein Zeiger auf eine Arbeitsaufgabenrückrufroutine, die vom Miniport bereitgestellt wird. Diese Routine wird im Kontext des Systemthreads aufgerufen, um die geplante Arbeitsaufgabe zu verarbeiten, auf die Worker verweist.

[in] Worker

Ein Zeiger auf einen undurchsichtigen Puffer für die zugeordnete und initialisierte Arbeitsaufgabe, die von StorPortInitializeWorkerzurückgegeben wird.

[in, optional] Context

Optionaler Kontext für die Worker-, die von der Rückrufroutine in WorkItemCallbackverarbeitet wird.

Rückgabewert

StorPortQueueWorkItem Routine gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_BUSY	Die Arbeitsaufgabe wird bereits zur Verarbeitung in die Warteschlange gestellt.
STOR_STATUS_INVALID_DEVICE_STATE	Die Arbeitsaufgabe kann nicht in die Warteschlange gestellt werden, da das Gerät entfernt wird.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL ist größer als DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, Workeroder WorkItemCallback ist NULL.
STOR_STATUS_SUCCESS	Die Arbeitsaufgabe wurde erfolgreich in die Warteschlange gestellt.

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

HwStorWorkItem-

StorPortFreeWorker

StorPortInitializeWorker

Freigeben über