Metodo IVideoWindow::p ut_FullScreenMode (control.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il put_FullScreenMode metodo abilita o disabilita il rendering video a schermo intero.

Sintassi

HRESULT put_FullScreenMode(
  [in] long FullScreenMode
);

Parametri

[in] FullScreenMode

Valore booleano che specifica se abilitare o disabilitare la modalità schermo intero. Deve essere uno dei valori seguenti:

Valore	Descrizione
OATRUE	Passare alla modalità schermo intero.
OAFALSE	Disabilitare la modalità schermo intero. (impostazione predefinita).

Valore restituito

I valori restituiti possibili includono quanto segue:

Codice restituito	Descrizione
E_NOTIMPL	Il filtro non supporta la modalità schermo intero.
S_FALSE	Già nella modalità richiesta.
S_OK	Operazione completata.
VFW_E_NO_FULLSCREEN	Impossibile trovare alcun filtro che supporta la modalità schermo intero.

Commenti

A seconda del renderer video, il passaggio alla modalità schermo intero potrebbe non essere visibile fino a quando l'applicazione non viene eseguita o sospesa il grafico. In modalità schermo intero, se l'utente passa dall'applicazione (ad esempio usando ALT + TAB), Filter Graph Manager invia un evento EC_FULLSCREEN_LOST .

Le osservazioni seguenti descrivono come Filter Graph Manager implementa la modalità schermo intero. Gli sviluppatori di applicazioni possono probabilmente ignorare queste informazioni, ma può essere utile se si sta scrivendo un renderer video personalizzato.

Quando un'applicazione passa alla modalità a schermo intero, Filter Graph Manager cerca un renderer video che funzionerà in modo più efficiente. In ordine di preferenza, questi sono:

1. Qualsiasi renderer video nel grafico del filtro che supporta in modo nativo la modalità schermo intero.
2. Qualsiasi renderer video nel grafico del filtro che può estendere il video a schermo intero senza un costo significativo delle prestazioni.
3. Filtro Renderer a schermo intero .
4. Qualsiasi renderer video nel grafico del filtro che supporta IVideoWindow.

Per la prima opzione, Filter Graph Manager chiama IVideoWindow::get_FullScreenMode in ogni renderer video nel grafico. La maggior parte dei renderer restituisce E_NOTIMPL, che indica che il filtro non supporta in modo nativo la modalità schermo intero. Se un renderer restituisce un valore non uguale a E_NOTIMPL, Filter Graph Manager usa tale valore.

Per la seconda opzione, Filter Graph Manager chiama IVideoWindow::GetMaxIdealImageSize e GetMinIdealImageSize in ogni renderer video nel grafico. Se le dimensioni dello schermo rientrano nell'intervallo segnalato del filtro, indica che il filtro può estendere il video senza un costo significativo delle prestazioni.

Ad eccezione dell'hardware precedente, la seconda opzione avrà esito positivo. La terza opzione consiste nell'usare il filtro Renderer a schermo intero, aggiungendolo al grafico, se necessario. La quarta opzione consiste semplicemente nel trovare il primo renderer nel grafico che supporta IVideoWindow e estendere il video indipendentemente dalle prestazioni.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	control.h (includere Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IVideoWindow

IVideoWindow::get_FullScreenMode