CMsgThread (clase)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
La CMsgThread clase es una clase de subproceso de trabajo que pone en cola las solicitudes al subproceso de puesta en cola para completarse de forma asincrónica. Para usar esta clase, derive la clase de ella e invalide la función miembro CMsgThread::ThreadMessageProc . La función miembro ThreadMessageProc lleva a cabo cada solicitud. Las funciones de cliente y la función miembro ThreadMessageProc deben compartir una definición común de los parámetros en el objeto CMsg .
Un mecanismo negociado indica al subproceso de trabajo que salga. Normalmente, este será un valor del código de mensaje de la clase UMsg de la clase CMsg .
Es recomendable enviar este mensaje desde el destructor de la clase derivada y llamar a la función miembro CMsgThread::WaitForThreadExit antes de completar la destrucción de la clase derivada.
| Miembros de datos protegidos | Descripción |
|---|---|
| m_hSem | Indica un identificador utilizado para la señalización. |
| m_Lock | Protege el acceso a las listas. |
| m_lWaiting | Indica la espera de un subproceso libre. |
| m_ThreadQueue | Invalida la función miembro CMsgThread::GetThreadMsg y bloquea elementos distintos de esta cola. |
| Funciones de miembro | Descripción |
| CMsgThread | Construye un objeto CMsgThread . |
| CreateThread | Crea un subproceso. |
| GetThreadHandle | Recupera el identificador de subproceso. |
| GetThreadID | Recupera el identificador del subproceso. |
| GetThreadPriority | Recupera la prioridad del subproceso actual. |
| PutThreadMsg | Pone en cola una solicitud de ejecución por el subproceso de trabajo. |
| ResumeThread | Continúa la operación del subproceso de trabajo. |
| SetThreadPriority | Establece la prioridad del subproceso en un nuevo valor. |
| SuspendThread | Suspende la operación de un subproceso en ejecución. |
| WaitForThreadExit | Bloquea hasta que el subproceso se haya salido después de una llamada a la función miembro CMsgThread::SuspendThread . |
| Funciones miembro reemplazables | Descripción |
| GetThreadMsg | Recupera un objeto CMsg en cola que contiene una solicitud. |
| OnThreadInit | Proporciona inicialización en un subproceso. |
| ThreadMessageProc | Procesa las solicitudes. Se trata de una función miembro virtual pura. |