Metodo IDeviceControl2::SelectVideoModePreference (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SelectVideoModePreference metodo imposta la visualizzazione in modalità video specificata (schermo wide, letterbox o pan-scan) per la riproduzione.

Sintassi

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Parametri

[in] ulPreferredDisplayMode

Valore che specifica la nuova modalità di visualizzazione per il contenuto DVD. Membro dell'enumerazione DVD_PREFERRED_DISPLAY_MODE .

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
Argomento non valido.
VFW_E_DVD_INVALIDDOMAIN
dominio non valido.
VFW_E_DVD_OPERATION_INHIBITED
Il controllo UOP impedisce l'operazione.

Commenti

Questo metodo modifica le proporzioni della finestra video predefinita e può anche specificare un meccanismo di conversione delle proporzioni predefinito.

Per il video di origine anamorfico 16 x 9, formato estendendo il video di origine 720 x 480 a 16 x 9 proporzioni.

Widescreen Il video di origine 16 x 9 deve essere posizionato e esteso all'area più grande 16 x 9 della finestra di output del client. Le evidenziazioni sono relative all'interno dell'area 16 x 9. Le barre nere devono essere aggiunte alla parte superiore/inferiore o ai lati per mantenere un'area 16 x 9.

Analisi panoramica Il video mostrato viene calcolato prendendo una sottofinestra 4 x 3 dal video esteso 16 x 9 (l'offset orizzontale viene fornito nell'offset della finestra del video MPEG-2). La finestra secondaria 4 x 3 viene inserita nella più grande area 4 x 3 della finestra del client di output. Le coordinate dell'evidenziazione sono relative alla finestra di output 4 x 3 (e non hanno alcuna relazione con il video di origine 16 x 9). Le barre nere devono essere aggiunte alla parte superiore/inferiore o ai lati per mantenere un'area 4 x 3.

Letterbox Un'area di visualizzazione 4 x 3 è formata prendendo la più grande area 4 x 3 della finestra del client di output. Le barre nere devono essere aggiunte alla parte superiore/inferiore o ai lati per mantenere un'area 4 x 3. Il video di origine 16 x 9 è posizionato nella finestra secondaria più grande 16 x 9 all'interno della sottofinestra 4 x 3. Le barre nere devono essere aggiunte alla parte superiore e inferiore della finestra secondaria per mantenere un'area 16 x 9. Le coordinate dell'evidenziazione sono relative alla sottofinestra 4 x 3 (e non hanno alcuna relazione con il video di origine 16 x 9). È tecnicamente possibile che un disco specifichi un'evidenziazione esterna all'area 16 x 9 (ma ancora nella finestra 4 x 3).

Per 4 x 3 video, il video viene posizionato nell'area di output più grande 4 x 3 della finestra del client di output. Le barre nere devono essere aggiunte alla parte superiore/inferiore o ai lati per mantenere un'area 4 x 3.

La tabella seguente illustra il nome del comando Allegato J a cui corrisponde questo nome di metodo e i domini in cui questo metodo è valido.

Nome comando J allegato Domini validi
Video_Presentation_Mode_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia I AvessiControl2