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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El PlayChaptersAutoStop método reproduce el número de capítulos especificados, comenzando en el capítulo especificado dentro del título especificado.

Sintaxis

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

Parámetros

[in] ulTitle

Valor que especifica el título en el que se encuentra el capítulo; este valor debe estar comprendido entre 1 y 99.

[in] ulChapter

Valor que especifica el capítulo del título especificado donde el navegador de DVD iniciará la reproducción; este valor debe estar comprendido entre 1 y 999.

[in] ulChaptersToPlay

Número de capítulos que se van a reproducir desde el capítulo inicial.

[in] dwFlags

OR bit a bit de una o varias marcas de la enumeración DVD_CMD_FLAGS, especificando cómo sincronizar el comando.

[out] ppCmd

Recibe un puntero a un objeto IDvdCmd que se puede usar para sincronizar comandos de DVD. El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL. Para obtener más información, vea Sincronizar comandos de DVD.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Correcto.
E_UNEXPECTED	El navegador de DVD no se inicializa o el título no es un título PGC secuencial.
E_INVALIDARG	El valor ulTitle no existe o es mayor que el número de títulos, o ulChapter no existe o es mayor que el número de capítulos, o ulChapter más ulChaptersToPlay es mayor que el número de capítulos.
VFW_E_DVD_GRAPHNOTREADY	El gráfico no está en estado de ejecución.

Comentarios

Este método solo funciona en One_Sequential_PGC_Titles. Cuando se ha reproducido el número especificado de capítulos, el navegador de DVD envía a la aplicación una notificación de eventos EC_DVD_CHAPTER_AUTOSTOP .

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre del comando Anexo J	Dominios válidos
Ninguno.	Todos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdControl2 (interfaz)

Sincronizar comandos de DVD