StorPortSetPriorityThread, fonction (storport.h)
StorPortSetPriorityThread définit la priorité d’exécution d’un thread créé par miniport.
Syntaxe
ULONG StorPortSetPriorityThread(
[in] PVOID HwDeviceExtension,
[in] PVOID ThreadContext,
[in] STOR_THREAD_PRIORITY Priority
);
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension d’appareil matériel du miniport.
[in] ThreadContext
Pointeur vers le contexte de thread reçu dans un appel antérieur à StorPortCreateSystemThread.
[in] Priority
Valeur d’énumération STOR_THREAD_PRIORITY qui spécifie la priorité du thread à définir.
Valeur de retour
StorPortSetPriorityThread retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STOR_STATUS_SUCCESS | La priorité de thread spécifiée a été définie avec succès. |
| STOR_STATUS_INVALID_IRQL | Le niveau IRQL doit être égal à PASSIVE_LEVEL. |
| STOR_STATUS_INVALID_PARAMETER | Un ou plusieurs des paramètres fournis ne sont pas valides. |
| STOR_STATUS_UNSUCCESSFUL | Retourné pour d’autres raisons système internes. |
Remarques
Une miniporte peut appeler StorPortSetPriorityThread pour modifier la priorité du thread spécifié par ThreadContext.
Les threads, quelles que soient leurs priorités d’exécution respectives, sont exécutés à IRQL = PASSIVE_LEVEL. Pour plus d’informations, consultez priorités des threads.
Une miniport doit spécifier une valeur de priorité de thread qui évite les inversions de priorité au moment de l’exécution. Consultez threads dédiés aux appareils pour plus d’informations.
Exigences
| Exigence | Valeur |
|---|---|
| serveur minimum pris en charge | Windows Server 2022 |
| d’en-tête | storport.h |