CBaseControlWindow.put_Owner-Methode

[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 put_Owner -Methode legt das übergeordnete Fenster des Videofensters fest. Das übergeordnete Fenster leitet dann bestimmte Meldungen an das Videofenster weiter.

Syntax

HRESULT put_Owner(
   OAHWND Owner
);

Parameter

Besitzer

Handle für das übergeordnete Fenster.

Rückgabewert

Gibt NOERROR zurück.

Bemerkungen

Intern ruft diese Methode die Microsoft Win32 SetParent-Funktion auf, um den neuen Besitzer festzulegen, und legt den Stil des übergeordneten Fensters auf WS_CHILD fest. Das übergeordnete Fenster leitet dann bestimmte Nachrichtensätze (insbesondere Maus- und Tastaturnachrichten) an das Videofenster weiter.

Nachdem Sie den Besitzer des Videofensters festgelegt haben, müssen Sie den Besitzer auf NULL und die Fensterart des Besitzers auf WS_OVERLAPPED und WS_CLIPCHILDREN festlegen, bevor Sie das Filterdiagramm freigeben. Wenn Sie den Besitzer auf NULL festlegen, deaktiviert diese Methode das WS_CHILD Bit des übergeordneten Fensters. Wenn Sie den Besitzer nicht auf NULL festlegen, übergibt das übergeordnete Fenster weiterhin Nachrichten an das Videofenster, und beim Schließen der Anwendung treten wahrscheinlich Fehler auf.

Anforderungen

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

Siehe auch

CBaseControlWindow-Klasse