Metode IDvdInfo2::GetCurrentUOPS (strmif.h)
[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 ini GetCurrentUOPS mengambil sekumpulan bendera yang menunjukkan perintah navigasi mana, jika ada, penulis konten telah secara eksplisit dinonaktifkan untuk lokasi disk saat ini.
Sintaks
HRESULT GetCurrentUOPS(
[out] ULONG *pulUOPs
);
Parameter
[out] pulUOPs
Menerima nilai VALID_UOP_FLAG bitwise. Setiap bit mewakili status (valid atau tidak valid) dari operasi pengguna (UOP). Jika bit diatur, maka operasi pengguna tersebut dilarang. Lihat Keterangan.
Mengembalikan nilai
Mengembalikan salah satu nilai HRESULT berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Berhasil. |
|
pulUOP bukan penunjuk yang valid. |
Keterangan
Penulis DVD dapat menyisipkan perintah UOP di hampir semua tempat pada disk untuk melarang perintah navigasi yang jika tidak akan diizinkan dalam domain DVD saat ini. Dengan kata lain, perintah UOP memungkinkan penulis disk untuk mengambil alih izin navigasi yang biasa.
Aplikasi pemutar DVD biasanya tidak harus menggunakan metode ini karena DVD Navigator secara otomatis memeriksa semua izin UOP sebelum melanjutkan dengan perintah apa pun, dan akan mengembalikan VFW_E_DVD_OPERATION_INHIBITED dari metode apa pun jika perintah tidak valid di bawah UOP saat ini. Jika aplikasi Anda perlu melacak izin UOP saat ini sendiri, Anda dapat memanggil GetCurrentUOPS setiap kali izin UOP saat ini diperlukan, atau Anda dapat menangani pemberitahuan peristiwa EC_DVD_VALID_UOPS_CHANGE dalam perulangan pesan Anda dan mengambil informasi UOP dari parameter lParam1 . Pendekatan terakhir umumnya lebih efisien.
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 |