Metodo IVideoWindow::p ut_FullScreenMode (control.h)

  • Articolo

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

Nota Se il grafico viene arrestato, Filter Graph Manager sospende ogni renderer prima di chiamare questi metodi. In questo modo il renderer offre l'opportunità di inizializzare tutte le risorse necessarie, perché molti renderer non possono determinare questi valori mentre vengono arrestati.
 
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