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

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La PlayChaptersAutoStop méthode lit le nombre de chapitres spécifié, en commençant par le chapitre spécifié dans le titre spécifié.

Syntaxe

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

Paramètres

[in] ulTitle

Valeur qui spécifie le titre dans lequel se trouve le chapitre ; cette valeur doit être comprise entre 1 et 99.

[in] ulChapter

Valeur qui spécifie le chapitre dans le titre spécifié où le NAVIGATEUR DE DVD démarrera la lecture ; cette valeur doit être comprise entre 1 et 999.

[in] ulChaptersToPlay

Nombre de chapitres à lire à partir du chapitre de début.

[in] dwFlags

OR au niveau du bit d’un ou de plusieurs indicateurs de l’énumération DVD_CMD_FLAGS, en spécifiant comment synchroniser la commande.

[out] ppCmd

Reçoit un pointeur vers un objet IDvdCmd qui peut être utilisé pour synchroniser des commandes DVD. L’appelant doit libérer l’interface. Ce paramètre peut être NULL. Pour plus d’informations, consultez Synchronisation des commandes DVD.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Réussite.
E_UNEXPECTED	Le navigateur DE DVD n’est pas initialisé ou le titre n’est pas un titre PGC séquentiel.
E_INVALIDARG	La valeur ulTitle n’existe pas ou est supérieure au nombre de titres, ou ulChapter n’existe pas ou est supérieure au nombre de chapitres, ou ulChapter plus ulChaptersToPlay est supérieur au nombre de chapitres.
VFW_E_DVD_GRAPHNOTREADY	Le graphique n’est pas en cours d’exécution.

Remarques

Cette méthode fonctionne uniquement sur One_Sequential_PGC_Titles. Lorsque le nombre spécifié de chapitres a été lu, le NAVIGATEUR DE DVD envoie à l’application une notification d’événement EC_DVD_CHAPTER_AUTOSTOP .

Le tableau suivant indique le nom de la commande Annexe J auquel correspond ce nom de méthode et les domaines dans lesquels cette méthode est valide.

Nom de la commande Annexe J	Domaines valides
Aucun.	Toutes

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdControl2 Interface

Synchronisation des commandes DVD