HW_WORKITEM funzione di callback (storport.h)

Articolo
02/07/2025

Funzione di callback fornita da miniport per l'elaborazione di una richiesta di un elemento di lavoro Storport.

Sintassi

HW_WORKITEM HwWorkitem;

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

Parametri

[in] HwDeviceExtension

Puntatore all'area di archiviazione per hbA del driver miniport.

[in, optional] Context

Contesto facoltativo fornito dal miniport nel parametro callback di StorPortQueueWorkItem.

[in] Worker

Puntatore a un buffer opaco che contiene informazioni di contesto per l'elemento di lavoro restituito da StorPortInitializeWorker.

Valore restituito

Nessuno

Osservazioni

Se necessario, un elemento di lavoro può essere accodato all'interno di HwStorWorkItem. Chiamare StorPortQueueWorkItem con l'elemento di lavoro corrente per riutilizzarlo. In caso contrario, chiamare StorPortFreeWorker per rilasciare l'elemento di lavoro.

Non vengono acquisiti blocchi da Storport quando viene richiamato il callback. Il miniport è responsabile di qualsiasi sincronizzazione necessaria nella routine di callback.

Il nome HwStorWorkItem è solo un segnaposto per la funzione miniport a cui fa riferimento il parametro callback di StorPortQueueWorkItem. Il prototipo effettivo di questa routine viene definito in Storport.h come indicato di seguito:

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

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 8 e versioni successive di Windows.
piattaforma di destinazione	Universale
intestazione	storport.h (include Storport.h)
IRQL	PASSIVE_LEVEL

Vedere anche

StorPortFreeWorker

StorPortInitializeWorker

StorPortQueueWorkItem

Condividi tramite