Freigeben über


IDvdControl2::ActivateAtPosition-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die ActivateAtPosition -Methode aktiviert die Menüschaltfläche unter der Mauszeigerposition.

Syntax

HRESULT ActivateAtPosition(
  [in] POINT point
);

Parameter

[in] point

Zeigen Sie auf den Clientfensterbereich in Pixelkoordinaten des Bildschirms.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Der Klick ist im hervorgehobenen Schaltflächenrechteck aufgetreten, und die Schaltfläche wurde erfolgreich aktiviert.
E_INVALIDARG
Der Punkt liegt außerhalb des gültigen Videobereichs.
E_UNEXPECTED
Die Schaltfläche ist vorhanden, funktioniert aber nicht.
VFW_E_DVD_INVALIDDOMAIN
Der DVD-Navigator befindet sich nicht in einer Menüdomäne.
VFW_E_DVD_NO_BUTTON
Es gibt keine Menüschaltfläche unter der Mauszeigerposition.
VFW_E_DVD_OPERATION_INHIBITED
Der Vorgang wird durch die Benutzeroperationssteuerung (User Operation, UOP) gehemmt.

Hinweise

Die Mauszeigerkoordinaten sind relativ zur oberen linken Ecke des Clientbereichs, der nicht unbedingt der Videoanzeigebereich ist, wenn das Video im Letterboxformat vorliegt.

Verwenden Sie diese Methode, wenn der Benutzer durch ein Menü navigiert, indem er den Mauszeiger direkt über die Menüschaltflächen bewegt. Wenn der Benutzer die relativen Schaltflächen verwendet, um im Menü zu navigieren, verwenden Sie ActivateButton anstelle ActivateAtPositionvon .

Die folgende Tabelle enthält den Namen des Anhangs J-Befehls, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname Gültige Domänen
Keine
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu

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

Fehler- und Erfolgscodes

IDvdControl2-Schnittstelle

Arbeiten mit DVD-Menüs