Metodo IDeviceControl2::ShowMenu (strmif.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 ShowMenu metodo visualizza il menu specificato, se disponibile.

Sintassi

HRESULT ShowMenu(
  [in]  DVD_MENU_ID MenuID,
  [in]  DWORD       dwFlags,
  [out] IDvdCmd     **ppCmd
);

Parametri

[in] MenuID

Valore di enumerazione DVD_MENU_ID che specifica il menu da visualizzare.

[in] dwFlags

OR bit per bit di uno o più flag dall'enumerazione DVD_CMD_FLAGS , specificando come sincronizzare il comando.

[out] ppCmd

Riceve un puntatore a un oggetto IOptionCmd che può essere usato per sincronizzare i comandi DVD. Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Per altre informazioni, vedere Sincronizzazione dei comandi DVD.

Valore restituito

Restituisce uno dei valori seguenti.

Commenti

Il menu Gestione video (VMGM) deve essere accessibile dai domini Titolo o Set di titolo video. I menu Set di titolo video (VTSMs) potrebbero essere accessibili solo tramite VMGM. Qualsiasi sottomenu in ogni VTSM (per capitoli, angoli e flussi audio e sottopicture) è accessibile solo tramite tale VTSM.

Questo metodo è illustrato nell'applicazione DVDSample in CDeviceCore::RootMenu e CDeviceCore::TitleMenu.

Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.

Requisiti

Vedi anche

Applicazioni DVD

Codici errore e esito positivo

Interfaccia ICollectionControl2

Uso dei menu DVD