CMsgThread, classe
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La CMsgThread classe est une classe worker-thread qui met en file d’attente les demandes au thread de mise en file d’attente pour l’achèvement de façon asynchrone. Pour utiliser cette classe, dérivez votre classe de celle-ci et remplacez la fonction membre CMsgThread::ThreadMessageProc . La fonction membre ThreadMessageProc exécute chaque requête. Vos fonctions clientes et la fonction membre ThreadMessageProc doivent partager une définition commune des paramètres dans l’objet CMsg .
Un mécanisme négocié indique au thread de travail de quitter. En règle générale, il s’agit d’une valeur du code de message uMsg de la classe CMsg.
Il est judicieux d’envoyer ce message à partir du destructeur de votre classe dérivée et d’appeler la fonction membre CMsgThread::WaitForThreadExit avant de terminer la destruction de la classe dérivée.
| Membres de données protégés | Description |
|---|---|
| m_hSem | Indique un handle utilisé pour la signalisation. |
| m_Lock | Protège l’accès aux listes. |
| m_lWaiting | Indique l’attente d’un thread libre. |
| m_ThreadQueue | Remplace la fonction membre CMsgThread::GetThreadMsg et bloque d’autres éléments que cette file d’attente. |
| Fonctions de membre | Description |
| CMsgThread | Construit un objet CMsgThread . |
| CreateThread | Crée un thread. |
| GetThreadHandle | Récupère le handle de thread. |
| GetThreadID | Récupère l’identificateur du thread. |
| GetThreadPriority | Récupère la priorité du thread actuel. |
| PutThreadMsg | Met en file d’attente une demande d’exécution par le thread de travail. |
| ResumeThread | Continue l’opération du thread de travail. |
| SetThreadPriority | Définit la priorité du thread sur une nouvelle valeur. |
| SuspendThread | Interrompt l’opération d’un thread en cours d’exécution. |
| WaitForThreadExit | Se bloque jusqu’à ce que le thread se soit arrêté après un appel à la fonction membre CMsgThread::SuspendThread . |
| Fonctions membres substituables | Description |
| GetThreadMsg | Récupère un objet CMsg mis en file d’attente contenant une requête. |
| OnThreadInit | Fournit l’initialisation sur un thread. |
| ThreadMessageProc | Traite les demandes. Il s’agit d’une fonction membre virtuelle pure. |