Metode IDvdInfo2::GetButtonAtPosition (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode GetButtonAtPosition mengambil tombol yang terletak di titik yang ditentukan dalam jendela tampilan.

Sintaks

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

Parameter

[in] point

Posisi penunjuk mouse saat ini seperti yang diambil melalui pesan win32 WM_MOUSEMOVE.

[out] pulButtonIndex

Menerima indeks (dari 1 hingga 36) tombol pada posisi penunjuk mouse saat ini.

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Argumen tidak valid.
E_POINTER	Parameter puButtonIndex tidak valid.
VFW_E_DVD_NO_BUTTON	Tidak ada tombol di titik.

Keterangan

Metode ini biasanya dipanggil sebagai respons terhadap perpindahan penunjuk mouse dalam jendela tampilan menu DVD. Pastikan untuk memeriksa keberhasilan di HRESULT sebelum mencoba mengambil nomor tombol; metode ini hanya menetapkan nilai puButtonIndex jika tombol ditemukan pada titik yang ditentukan. Tombol DVD tidak selalu memiliki persegi panjang yang disorot, persegi panjang tombol dapat tumpang tindih, dan persegi panjang tombol tidak selalu sesuai dengan representasi visual tombol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Aplikasi DVD

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdInfo2

Bagikan melalui