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

  • Article

[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