Metodo CMsgThread.ThreadMessageProc

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Elabora le richieste. Si tratta di una funzione membro virtuale pura.

Sintassi

virtual LRESULT ThreadMessageProc(
   UINT     uMsg,
   DWORD    dwFlags,
   LPVOID   lpParam,
   CAMEvent *pEvent
);

Parametri

Umsg

Codice della richiesta.

dwFlags

Parametro di flag facoltativo da richiedere.

lpParam

Puntatore facoltativo a dati aggiuntivi o a un blocco di dati restituito.

Pevent

Puntatore facoltativo a un oggetto evento.

Valore restituito

Qualsiasi valore diverso da zero causa l'uscita del thread. Restituisce zero a meno che una richiesta di uscita non sia stata elaborata di recente.

Commenti

Questa funzione virtuale pura deve essere sottoposta a override nella classe derivata. Verrà chiamato una volta per ogni richiesta accodata da una chiamata alla funzione membro CMsgThread::P utThreadMsg .

La funzione membro definisce i quattro parametri. In genere, usare il parametro uMsg per indicare la richiesta e gli altri tre parametri saranno parametri aggiuntivi facoltativi. L'applicazione chiamante può fornire un puntatore a un oggetto CAMEvent nel parametro pEvent se l'applicazione lo richiede. È necessario impostare questo evento dopo l'elaborazione dell'evento usando un'espressione, ad esempio:

pEvent->SetEvent

È necessario riservare un codice di richiesta per indicare al thread di lavoro di uscire. Al momento della ricezione di questa richiesta, restituire 1 dalla funzione membro. Restituisce 0 se non si vuole che il thread di lavoro venga chiuso.

Requisiti

Requisito Valore
Intestazione
Msgthrd.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CMsgThread