HW_WORKITEM Rückruffunktion (storport.h)

Artikel
02/26/2024

Eine vom Miniport bereitgestellte Rückruffunktion zum Verarbeiten einer Storport-Arbeitselementanforderung.

Syntax

HW_WORKITEM HwWorkitem;

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf den HBA-Speicherbereich des Miniporttreibers.

[in, optional] Context

Optionaler Kontext, der vom Miniport im Rückrufparameter von StorPortQueueWorkItem bereitgestellt wird.

[in] Worker

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

Rückgabewert

Keine

Bemerkungen

Bei Bedarf kann ein Arbeitselement innerhalb von HwStorWorkItem in eine Warteschlange gestellt werden. Rufen Sie StorPortQueueWorkItem mit dem aktuellen Arbeitselement auf, um es wiederzuverwenden. Rufen Sie andernfalls StorPortFreeWorker auf, um das Arbeitselement freizugeben.

Storport erhält keine Sperren, wenn der Rückruf aufgerufen wird. Der Miniport ist für alle Synchronisierungen verantwortlich, die in der Rückrufroutine erforderlich sind.

Der Name HwStorWorkItem ist nur ein Platzhalter für die Miniportfunktion, auf die der Rückrufparameter von StorPortQueueWorkItem verweist. 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
Unterstützte Mindestversion (Client)	Verfügbar in Windows 8 und höheren Versionen von Windows.
Zielplattform	Universell
Header	storport.h (einschließlich Storport.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

StorPortFreeWorker

StorPortInitializeWorker

StorPortQueueWorkItem

Freigeben über