Metodo IDeviceControl2::P layChapter (strmif.h)

Articolo
07/28/2023

[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 PlayChapter metodo avvia la riproduzione dal capitolo specificato nel titolo corrente.

Sintassi

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

Parametri

[in] ulChapter

Valore che specifica il capitolo nel titolo corrente in cui il navigatore 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 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.

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

Commenti

Il navigatore DVD inizia la riproduzione nel capitolo specificato e continua ai capitoli successivi. Usare IDeviceControl2::P layChaptersAutoStop per riprodurre solo il capitolo corrente.

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.

Questo metodo è illustrato nell'applicazione DVDSample in CDeviceCore::P layChapter.

Nome comando J allegato	Domini validi
PTT_Search	DVD_DOMAIN_Title

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 errore e esito positivo

Interfaccia ICollectionControl2

Sincronizzazione dei comandi DVD

Condividi tramite