CBaseControlWindow.NotifyOwnerMessage-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die NotifyOwnerMessage -Methode übergibt bestimmte Meldungen an das Videofenster.

Syntax

HRESULT NotifyOwnerMessage(
   long     hwnd,
   long     uMsg,
   LONG_PTR wParam,
   LONG_PTR lParam
);

Parameter

hwnd

Handle mit dem Videofenster.

uMsg

Nachrichtendetails.

wParam

Erster Nachrichtenparameter.

lParam

Zweiter Nachrichtenparameter.

Rückgabewert

Gibt NO_ERROR zurück.

Bemerkungen

Wenn das Videofenster ein untergeordnetes Element eines anderen Fensters ist, empfängt es bestimmte Fensternachrichten der obersten Ebene nicht. Diese Nachrichten können für einen Renderer nützlich sein, da sie sich auf sein Verhalten auswirken können. NotifyOwnerMessage übergibt eine der folgenden Meldungen an das Videofenster.

  • WM_ACTIVATEAPP
  • WM_DEVMODECHANGE
  • WM_DISPLAYCHANGE
  • WM_PALETTECHANGED
  • WM_PALETTEISCHANGING
  • WM_QUERYNEWPALETTE
  • WM_SYSCOLORCHANGE

Sie können anfordern, dass der IVideoWindow-Plug-In-Verteiler (PID) ein Fenster zu einem untergeordneten Element eines anderen Fensters macht. In diesem Fall sucht die PID nach bestimmten Nachrichten, die möglicherweise an das besitzereigene Fenster gesendet werden. Die PID leitet diese Nachrichten dann an das eigene Fenster weiter. Die Standardverarbeitung für die Nachrichten besteht darin, sie synchron an die eigene Fensterprozedur zu senden, indem die Win32 SendMessage-Funktion aufgerufen wird.

Anforderungen

Anforderung Wert
Header
Ctlutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseControlWindow-Klasse