HW_WORKITEM fonction de rappel (storport.h)

Article
02/07/2025

Fonction de rappel miniport fournie pour le traitement d’une demande d’élément de travail Storport.

Syntaxe

HW_WORKITEM HwWorkitem;

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

Paramètres

[in] HwDeviceExtension

Pointeur vers la zone de stockage par hBA du pilote miniport.

[in, optional] Context

Contexte facultatif fourni par le miniport dans le paramètre Callback de StorPortQueueWorkItem.

[in] Worker

Pointeur vers une mémoire tampon opaque qui contient des informations de contexte pour l’élément de travail retourné par StorPortInitializeWorker.

Valeur de retour

Aucun

Remarques

Si nécessaire, un élément de travail peut être mis en file d’attente dans HwStorWorkItem. Appelez StorPortQueueWorkItem avec l’élément de travail actuel pour le réutiliser. Sinon, appelez StorPortFreeWorker pour libérer l’élément de travail.

Aucun verrou n’est acquis par Storport lorsque le rappel est appelé. Le miniport est responsable de toute synchronisation requise dans la routine de rappel.

Le nom HwStorWorkItem n’est qu’un espace réservé pour la fonction miniport pointée par le paramètre Callback de StorPortQueueWorkItem. Le prototype réel de cette routine est défini dans Storport.h comme suit :

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

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 8 et versions ultérieures de Windows.
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
IRQL	PASSIVE_LEVEL

Voir aussi

StorPortFreeWorker

StorPortInitializeWorker

StorPortQueueWorkItem

Partager via