Método IDvdControl2::P layChapter (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O PlayChapter método inicia a reprodução do capítulo especificado no título atual.

Sintaxe

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

Parâmetros

[in] ulChapter

Valor que especifica o capítulo no título atual em que o Navegador de DVD iniciará a reprodução; esse valor deve ser de 1 a 999.

[in] dwFlags

OR bit a bit de um ou mais sinalizadores da enumeração DVD_CMD_FLAGS, especificando como sincronizar o comando.

[out] ppCmd

Recebe um ponteiro para um objeto IDvdCmd que pode ser usado para sincronizar comandos de DVD. O chamador deve liberar a interface . Este parâmetro pode ser NULL. Para obter mais informações, consulte Sincronizando comandos de DVD.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
VFW_E_DVD_OPERATION_INHIBITED	O controle UOP proíbe a operação.
E_INVALIDARG	Argumento inválido.

Comentários

O Navegador de DVD começa a reprodução no capítulo especificado e continua nos capítulos subsequentes. Use IDvdControl2::P layChaptersAutoStop para reproduzir somente o capítulo atual.

A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.

Esse método é demonstrado no aplicativo DVDSample em CDvdCore::P layChapter.

Nome do comando Anexo J	Domínios válidos
PTT_Search	DVD_DOMAIN_Title

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Aplicativos de DVD

Códigos de erro e êxito

IDvdControl2 Interface

Sincronizando comandos de DVD