StorPortInitializeWorker, fonction (storport.h)

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 retournée

La routine StorPortInitializeWorker retourne l’un des codes status suivants :

Code de retour	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 disponibles sont insuffisantes pour initialiser le contexte de l’é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 d’appeler StorPortInitializeWorker pendant la fonction HwStorFindAdapter du miniport pour garantir que les ressources sont disponibles si nécessaire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 8 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
IRQL	<= DISPATCH_LEVEL

Voir aussi

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem