IDvdInfo2::GetCurrentAngle-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetCurrentAngle -Methode ruft die Anzahl der verfügbaren Winkel im aktuellen Winkelblock und die aktuell ausgewählte Winkelnummer ab.

Syntax

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

Parameter

[out] pulAnglesAvailable

Empfängt die Anzahl der verfügbaren Winkel. Es gibt bis zu neun Winkel in einem Winkelblock, nummeriert 1 bis 9. Wenn der Wert gleich 1 ist, befindet sich der DVD-Navigator nicht in einem Winkelblock.

[out] pulCurrentAngle

Empfängt die aktuelle Winkelnummer.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_POINTER
Ungültiges Argument.
VFW_E_DVD_INVALIDDOMAIN
DVD Navigator wird nicht oder nicht in einer gültigen Domäne initialisiert.

Hinweise

Beachten Sie, dass Winkel- und Menüschaltflächenindizes 1-basiert sind, während audio- und subpicture-Streamindizes 0-basiert sind. Wenn der DVD Navigator im Begriff ist, einen Winkelblock einzugeben, sendet er der Anwendung eine EC_DVD_ANGLES_AVAILABLE Ereignisbenachrichtigung, wobei lParam auf 1 festgelegt ist. Anwendungen rufen GetCurrentAngle in der Regel IDvdControl2::SelectAngle in ihrem Ereignishandler für EC_DVD_ANGLES_AVAILABLE auf.

Diese Methode wird in der DVDSample-Anwendung in CAngleDlg::MakeAngleList veranschaulicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

DVD-Anwendungen

EC_DVD_ANGLES_AVAILABLE

EC_DVD_ANGLE_CHANGE

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle