Metodo CBaseControlWindow.GetMaxIdealImageSize

  • 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 GetMaxIdealImageSize metodo recupera le dimensioni massime dell'immagine ideale.

Sintassi

HRESULT GetMaxIdealImageSize(
   long *pWidth,
   long *pHeight
);

Parametri

pWidth

Puntatore alla larghezza massima ideale, in pixel.

pHeight

Puntatore all'altezza massima ideale, in pixel.

Valore restituito

Restituisce un valore HRESULT .

Commenti

Vari renderer hanno restrizioni sulle prestazioni sulle dimensioni delle immagini che possono visualizzare. Anche se devono comunque funzionare correttamente quando richiesto di visualizzare immagini più grandi del massimo specificato, i renderer possono designare le dimensioni minime e massime ideali tramite l'interfaccia IVideoWindow . Questa interfaccia può essere chiamata solo quando il grafico del filtro viene sospeso o in esecuzione, perché non è fino a quando le risorse vengono allocate e il renderer può riconoscere le relative restrizioni. Se non esistono restrizioni, il renderer riempie i parametri pWidth e pHeight con le dimensioni del video nativo e restituisce S_FALSE. Se esistono restrizioni, la larghezza e l'altezza limitate vengono immesse e la funzione membro restituisce S_OK.

Le dimensioni si applicano alle dimensioni del video di destinazione e non alle dimensioni complessive della finestra. Quindi, quando si calcolano le dimensioni della finestra da impostare, tenere conto degli stili di finestra correnti, ad esempio WS_CAPTION e WS_BORDER.

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseControlWindow