Metodo IDeviceControl2::P layChapterInTitle (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 PlayChapterInTitle metodo avvia la riproduzione dall'inizio del capitolo specificato del titolo specificato.

Sintassi

HRESULT PlayChapterInTitle(
  [in]  ULONG   ulTitle,
  [in]  ULONG   ulChapter,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parametri

[in] ulTitle

Valore che specifica il titolo in cui si trova il capitolo; questo valore deve essere compreso tra 1 e 99.

[in] ulChapter

Valore che specifica il capitolo nel titolo specificato in cui lo strumento di navigazione dvd inizierà la riproduzione; questo valore deve essere compreso tra 1 e 999.

[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 IItemCmd che può essere utilizzato 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.

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

Commenti

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.

Questo metodo viene illustrato nell'applicazione DVDSample in CConfigurationCore::P layChapterInTitle.

Nome comando J allegato Domini validi
PTT_Play
  • 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

Sincronizzazione dei comandi DVD