HW_WORKITEM Rückruffunktion (storport.h)

Artikel
02/07/2025

Eine miniport-bereitgestellte Rückruffunktion für die Verarbeitung einer Storport-Arbeitsaufgabenanforderung.

Syntax

HW_WORKITEM HwWorkitem;

void HwWorkitem(
  [in]           PVOID HwDeviceExtension,
  [in, optional] PVOID Context,
  [in]           PVOID Worker
)
{...}

Parameter

[in] HwDeviceExtension

Ein Zeiger auf den Miniporttreiber pro HBA-Speicherbereich.

[in, optional] Context

Optionaler Kontext, der vom Miniport im Callback Parameter von StorPortQueueWorkItembereitgestellt wird.

[in] Worker

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

Rückgabewert

Nichts

Bemerkungen

Bei Bedarf kann eine Arbeitsaufgabe innerhalb HwStorWorkItem-in die Warteschlange gestellt werden. Rufen Sie StorPortQueueWorkItem- mit der aktuellen Arbeitsaufgabe auf, um sie wiederzuverwenden. Rufen Sie andernfalls StorPortFreeWorker auf, um die Arbeitsaufgabe freizugeben.

Beim Aufrufen des Rückrufs werden keine Sperren von Storport abgerufen. Der Miniport ist für jede Synchronisierung verantwortlich, die in der Rückrufroutine erforderlich ist.

Der Name HwStorWorkItem- ist nur ein Platzhalter für die Miniportfunktion, auf den der Callback Parameter von StorPortQueueWorkItemverweist. Der eigentliche Prototyp dieser Routine wird in Storport.h wie folgt definiert:

typedef
VOID
HW_WORKITEM (
    _In_     PVOID HwDeviceExtension,
    _In_Opt_ PVOID Context,
    _In_     PVOID Worker,
    );

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-	PASSIVE_LEVEL

Siehe auch

StorPortFreeWorker

StorPortInitializeWorker

StorPortQueueWorkItem-

Freigeben über