StorPortQueueWorkItem, fonction (storport.h)
StorPortQueueWorkItem met en file d’attente un élément de travail Storport à exécuter dans le contexte d’un thread de travail système (noyau).
Syntaxe
ULONG StorPortQueueWorkItem(
[in] PVOID HwDeviceExtension,
[in] PHW_WORKITEM WorkItemCallback,
[in] PVOID Worker,
[in, optional] PVOID Context
);
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).
[in] WorkItemCallback
Pointeur vers une routine de rappel d’élément de travail fournie par le miniport. Cette routine est appelée dans le contexte du thread système pour traiter l’élément de travail planifié vers lequel worker pointe.
[in] Worker
Pointeur vers une mémoire tampon opaque pour l’élément de travail alloué et initialisé retourné par StorPortInitializeWorker.
[in, optional] Context
Contexte facultatif pour le Worker qui est traité par la routine de rappel dans WorkItemCallback.
Valeur retournée
La routine StorPortQueueWorkItem retourne l’un des codes status suivants :
| Code de retour | Description |
|---|---|
| STOR_STATUS_BUSY | L’élément de travail est déjà mis en file d’attente pour traitement. |
| STOR_STATUS_INVALID_DEVICE_STATE | L’élément de travail ne peut pas être mis en file d’attente car l’appareil est en cours de suppression. |
| STOR_STATUS_INVALID_IRQL | L’IRQL actuel est supérieur à DISPATCH_LEVEL. |
| STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension, Worker ou WorkItemCallback a la valeur NULL. |
| STOR_STATUS_SUCCESS | L’élément de travail a été correctement mis en file d’attente. |
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 |