IDirectDrawVideo::UseWhenFullScreen-Methode (amvideo.h)

Die UseWhenFullScreen -Methode bestimmt, ob DirectShow den Anzeigemodus beim Wechsel zum Vollbildmodus ändern soll.

Syntax

HRESULT UseWhenFullScreen(
  long UseWhenFullScreen
);

Parameter

UseWhenFullScreen

Wert, der angibt, ob der Anzeigemodus geändert werden soll. Legen Sie auf OATRUE fest, damit der Renderer DirectShow im Vollbildmodus verwendet. Legen Sie andernfalls auf OAFALSE fest.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Wenn Sie aufgefordert werden, zum Vollbildmodus zu wechseln, hat DirectShow eine Reihe von Optionen. Die erste Wahl besteht darin, zu ermitteln, ob filter im Diagramm die Vollbildwiedergabe direkt unterstützen können. wenn möglich, wird sie dazu aufgefordert.

Die zweite Wahl besteht darin, dem Filterdiagramm automatisch einen speziellen Vollbildrenderer hinzuzufügen, der directDraw-Moduswechseldienste verwendet, um das Video wiederzugeben. Durch das Ändern der Anzeigemodi füllt das Video effektiv mehr (aber nicht unbedingt alle) des Displays aus. Wenn der aktuelle Modus beispielsweise 1024 x 768 Pixel aufweist, kann ein Video relativ klein aussehen, aber wenn es in einem Anzeigemodus von 320 x 240 angezeigt wird, kann es sehr vorzeigbar aussehen.

Die dritte und letzte Wahl besteht darin, einfach jeden Renderer zu nehmen, der die IVideoWindow-Schnittstelle unterstützt, und sein Fenster wird vollbildgespannt. Dies bietet in der Regel eine geringere Leistung als die zweite Option (Austausch in einem DirectDraw-fähigen Renderer im Vollbildmodus). Wenn der Parameter UseWhenFullScreen auf Ein (OATRUE) festgelegt ist, wird das Fenster für die Vollbildwiedergabe immer im Vollbildmodus angezeigt. wenn auf Aus (Standard) festgelegt ist, kann der Filterdiagramm-Manager im Vollbildrenderer mit DirectDraw-Unterstützung ausgetauscht werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile amvideo.h (einschließlich Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IDirectDrawVideo-Schnittstelle