Méthode IDvdInfo2 ::GetCurrentAngle (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 GetCurrentAngle méthode récupère le nombre d’angles disponibles dans le bloc d’angle actuel et le nombre d’angle actuellement sélectionné.

Syntaxe

HRESULT GetCurrentAngle(
  [out] ULONG *pulAnglesAvailable,
  [out] ULONG *pulCurrentAngle
);

Paramètres

[out] pulAnglesAvailable

Reçoit le nombre d’angles disponibles. Il y a jusqu’à neuf angles dans un bloc d’angle, numérotés de 1 à 9. Si la valeur est égale à 1, le navigateur de DVD n’est pas dans un bloc d’angle.

[out] pulCurrentAngle

Reçoit le numéro d’angle actuel.

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	Réussite.
E_POINTER	Argument non valide.
VFW_E_DVD_INVALIDDOMAIN	DVD Navigator n’est pas initialisé ou n’est pas dans un domaine valide.

Remarques

Notez que les index de bouton d’angle et de menu sont basés sur 1, tandis que les index de flux audio et de sous-image sont basés sur 0. Lorsque le navigateur de DVD est sur le point d’entrer dans un bloc d’angle, il envoie à l’application une notification d’événement EC_DVD_ANGLES_AVAILABLE avec lParam défini sur 1. Les applications appellent GetCurrentAngle généralement et IDvdControl2 ::SelectAngle dans leur gestionnaire d’événements pour EC_DVD_ANGLES_AVAILABLE.

Cette méthode est illustrée dans l’application DVDSample dans CAngleDlg ::MakeAngleList.

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