CBaseControlWindow-Klasse

[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.]

Die CBaseControlWindow-Klasse implementiert die IVideoWindow-Schnittstelle und steuert den externen Zugriff auf den zugeordneten Filter. Sie müssen das CBaseControlWindow-Objekt mit dem Filter synchronisieren, indem Sie einen Zeiger auf ein kritisches Abschnittssynchronisierungsobjekt übergeben. Die CBaseControlWindow-Klasse stellt eine Reihe von Methoden bereit, die Eigenschafteneinstellungen zurückgeben, ohne sich mit diesem kritischen Abschnitt zu befassen. Wenn Sie beispielsweise CBaseControlWindow::get_AutoShow aufrufen, um den Wert des m_bAutoShow Datenmember abzurufen, wird der kritische Abschnitt gesperrt. Der Filter verfügt möglicherweise bereits über einen gesperrten internen kritischen Abschnitt, der die Sperrhierarchie des Filters verletzen könnte. Stattdessen gibt der Aufruf der CBaseControlWindow::IsAutoShowEnabled-Memberfunktion den erforderlichen Wert zurück, ohne dass sich dies auf den kritischen Abschnitt auswirkt.

Alle von CBaseControlWindow implementierten IVideoWindow-Methoden erfordern, dass der Filter ordnungsgemäß mit seinem Upstream-Filter verbunden ist. Aus diesem Grund benötigen Klassenobjekte einen Synchronisierungspin, den Sie durch Aufrufen der CBaseControlWindow::SetControlWindowPin-Methode festlegen. Wenn Sie eine IVideoWindow-Methode aufrufen, überprüft das CBaseControlWindow-Objekt , ob die Pin noch verbunden ist.

Geschützte Datenmember	BESCHREIBUNG
m_bAutoShow	Ergebnis, wenn sich der Zustand ändert.
m_bCursorHidden	Bestimmung, ob der Cursor angezeigt oder ausgeblendet wird.
m_BorderColour	Farbe des aktuellen Fensterrahmens.
m_hwndDrain	Fensterhandle, in dem empfangene Nachrichten gepostet werden.
m_hwndOwner	Besitzendes Fenster.
m_pFilter	Zeiger auf den eigenen Medienfilter.
m_pInterfaceLock	Extern definierter kritischer Abschnitt.
m_pPin	Steuerung der Medientypen für die Verbindung.
Elementfunktionen	BESCHREIBUNG
CBaseControlWindow	Erstellt ein CBaseControlWindow-Objekt .
DoGetWindowStyle	Ruft entweder die typischen oder erweiterten Fensterstile ab.
DoSetWindowStyle	Legt die typischen oder erweiterten Fensterstile fest.
GetBorderColour	Ruft die aktuelle Rahmenfarbe ab. Dies ist eine Hilfselementfunktion.
GetOwnerWindow	Ruft das besitzende Fenster ab. Dies ist eine Hilfselementfunktion.
IsAutoShowEnabled	Ruft Informationen darüber ab, ob das Videofenster automatisch angezeigt wird, wenn der Renderingfilter angehalten oder ausgeführt wird.
IsCursorHidden	Ruft den aktuellen Zustand des m_bCursorHidden Datenmembers ab, ohne den kritischen Abschnitt zu sperren. Dies ist eine Hilfselementfunktion.
MöglicherweiseEatMessage	Verteilt Nachrichten an das übergeordnete Fenster.
SetControlWindowPin	Benachrichtigt das Objekt des Pins, auf den es angewendet wird.
IVideoWindow-Methoden	BESCHREIBUNG
get_AutoShow	Ruft die aktuelle Einstellung für das AutoShow-Flag ab.
get_BackgroundPalette	Ruft die realisierte Palette im Hintergrundflag ab.
get_BorderColor	Ruft die aktuelle Rahmenfarbe ab.
get_Caption	Ruft das aktuelle Fenster Untertitel ab.
get_ FullScreenMode	Ruft den aktuellen Vollbildmodus ab.
get_Height	Ruft die aktuelle Fensterhöhe ab.
get_Left	Ruft die aktuelle linke Fensterkoordinate ab.
GetMaxIdealImageSize	Ruft die maximale Größe des idealen Bilds ab.
get_MessageDrain	Ruft die aktuelle Nachrichtenentwässerung ab.
GetMinIdealImageSize	Ruft die Mindestgröße des idealen Bilds ab.
get_Owner	Ruft das Handle des übergeordneten Fensters ab.
GetRestorePosition	Ruft die Position ab, an der das Fenster wiederhergestellt wird, wenn es maximiert oder minimiert wird.
get_Top	Ruft die y-Koordinate für den oberen Rand des Fensters ab.
get_Visible	Ruft die aktuelle Sichtbarkeitseinstellung des Fensters ab.
get_Width	Ruft die Breite des Fensters ab.
GetWindowPosition	Ruft die aktuellen Fensterkoordinaten ab.
get_WindowState	Ruft den aktuellen Zustand des Fensters ab.
get_WindowStyle	Ruft die Standardfensterstile ab.
get_WindowStyleEx	Ruft die erweiterten Fensterstile ab.
HideCursor	Blendet den Cursor aus oder zeigt diese an.
IsCursorHidden	Ruft den aktuellen Zustand des m_bCursorHidden-Datenmembers ab.
NotifyOwnerMessage	Übergibt Nachrichten, die an besitzereigene Fenster gesendet werden.
put_AutoShow	Legt die AutoShow-Eigenschaft fest.
put_BackgroundPalette	Legt ein Flag fest, um die Palette im Hintergrund zu erkennen.
put_BorderColor	Legt die aktuelle Rahmenfarbe fest.
put_Caption	Legt das aktuelle Fenster Untertitel fest.
put_ FullScreenMode	Legt den Vollbildmodus fest.
put_Height	Legt die aktuelle Fensterhöhe fest.
put_Left	Legt die linke Koordinate für das Fenster fest.
put_MessageDrain	Legt das Nachrichtenablauffenster fest.
put_Owner	Legt das übergeordnete Fensterhandle von Microsoft Win32 fest.
put_Top	Legt die Position für den oberen Bereich des Fensters fest.
put_Visible	Blendet das Fenster aus oder zeigt es an.
put_Width	Legt die Breite des Fensters fest.
put_WindowState	Legt den Status des Fensters fest.
put_WindowStyle	Legt die Standardfensterstile fest.
put_WindowStyleEx	Legt die Formatvorlagen für erweiterte Fenster fest.
SetWindowForeground	Legt das Fenster im Vordergrund fest.
SetWindowPosition	Legt die Fensterposition fest.

 

Siehe auch

DirectShow-Basisklassen