CMsgThread.PutThreadMsg-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Stellt eine Anforderung für die Ausführung durch den Workerthread in die Warteschlange.

Syntax

void PutThreadMsg(
   UINT     uMsg,
   DWORD    dwMsgFlags,
   LPVOID   lpMsgParam,
   CAMEvent *pEvent = NULL
);

Parameter

uMsg

Anforderungscode.

dwMsgFlags

Optionaler Flags-Parameter.

lpMsgParam

Optionaler Zeiger auf einen Datenblock, der zusätzliche Parameter oder Rückgabewerte enthält. Muss statisch oder heapseitig zugeordnet und nicht automatisch sein.

pEvent

Optionaler Zeiger auf ein Ereignisobjekt, das bei Abschluss signalisiert werden soll.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Memberfunktion stellt eine Anforderung für die Ausführung durch den Workerthread in die Warteschlange. Die Parameter dieser Memberfunktion werden (in einem CMsg-Objekt ) in die Warteschlange gestellt und an die CMsgThread::ThreadMessageProc-Memberfunktion des Workerthreads übergeben. Diese Memberfunktion gibt unmittelbar nach dem Anstehen der Anforderung zurück und wartet nicht, bis der Thread die Anforderung erfüllt. Die CMsgThread::ThreadMessageProc-Memberfunktion der abgeleiteten Klasse definiert die vier Parameter.

Diese Memberfunktion verwendet eine sichere Multithreadliste, sodass mehrere Aufrufe dieser Memberfunktion von verschiedenen Threads sicher erfolgen können.

Anforderungen

Anforderung Wert
Header
Msgthrd.h (einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CMsgThread-Klasse