IDvdInfo2::GetButtonAtPosition-Methode (strmif.h)

Artikel
03/06/2024

[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 GetButtonAtPosition -Methode ruft die Schaltfläche ab, die sich an dem angegebenen Punkt im Anzeigefenster befindet.

Syntax

HRESULT GetButtonAtPosition(
  [in]  POINT point,
  [out] ULONG *pulButtonIndex
);

Parameter

[in] point

Aktuelle Mauszeigerposition, wie sie über die Win32-WM_MOUSEMOVE-Nachricht abgerufen wird.

[out] pulButtonIndex

Empfängt den Index (von 1 bis 36) der Schaltfläche an der aktuellen Mauszeigerposition.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
E_POINTER	Der puButtonIndex-Parameter ist ungültig.
VFW_E_DVD_NO_BUTTON	Keine Schaltfläche zu einem Zeitpunkt.

Hinweise

Diese Methode wird in der Regel als Reaktion auf eine Mauszeigerbewegung innerhalb eines DVD-Menüanzeigefensters aufgerufen. Überprüfen Sie unbedingt, ob das HRESULT erfolgreich ist, bevor Sie versuchen, die Schaltflächennummer abzurufen. Diese Methode legt den Wert von puButtonIndex nur fest, wenn an dem angegebenen Punkt eine Schaltfläche gefunden wird. DVD-Schaltflächen verfügen nicht unbedingt über hervorgehobene Rechtecke, Schaltflächenrechtecke können sich überlappen, und Schaltflächenrechtecke entsprechen nicht immer der visuellen Darstellung der Schaltflächen.

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

IDvdInfo2-Schnittstelle

Freigeben über