StorPortInitializeWorker, fonction (storport.h)

Article
02/07/2025

Crée un élément de travail Storport qui s’exécute dans un thread de travail système.

Syntaxe

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[out] Worker

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

Valeur de retour

La routine StorPortInitializeWorker retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL actuel.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Worker a la valeur NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources insuffisantes sont disponibles pour initialiser le contexte d’élément de travail.
STOR_STATUS_SUCCESS	L’élément de travail a été initialisé avec succès.

Remarques

Le contexte de l’élément de travail retourné dans le paramètre Worker par StorPortInitializeWorker est utilisé dans les appels futurs à StorPortQueueWorkItem ou StorPortFreeWorker.

Si le miniport utilise l’élément de travail pendant le traitement des E/S, nous vous recommandons de StorPortInitializeWorker être appelée pendant le HwStorFindAdapter fonction pour vous assurer que les ressources sont disponibles si nécessaire.

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	<= DISPATCH_LEVEL

Voir aussi

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem

Partager via