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

Article
03/02/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 PlayChapterInTitle méthode démarre la lecture à partir du début du chapitre spécifié du titre spécifié.

Syntaxe

HRESULT PlayChapterInTitle(
  [in]  ULONG   ulTitle,
  [in]  ULONG   ulChapter,
  [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] 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.
VFW_E_DVD_OPERATION_INHIBITED	Le contrôle UOP interdit l’opération.
E_INVALIDARG	Argument non valide.

Notes

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

Cette méthode est illustrée dans l’application DVDSample dans CDvdCore ::P layChapterInTitle.

Nom de la commande Annexe J	Domaines valides
PTT_Play	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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

Partager via