Metode IWMDeviceManager3::SetDeviceEnumPreference (mswmdm.h)
Metode SetDeviceEnumPreference mengatur preferensi enumerasi perangkat.
Sintaks
HRESULT SetDeviceEnumPreference(
[in] DWORD dwEnumPref
);
Parameter
[in] dwEnumPref
Menentukan kombinasi bitwise OR dari satu atau beberapa nilai bit berikut yang menentukan preferensi enumerasi. Setiap bit yang ditetapkan memungkinkan perilaku yang diperluas yang sesuai, sedangkan tidak adanya bit tersebut menonaktifkan perilaku yang diperluas dan menentukan perilaku enumerasi default yang kompatibel dengan mundur. Nilai yang mungkin untuk fuPrefs disediakan dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES | Secara default, untuk perangkat yang berisi beberapa media penyimpanan (misalnya, beberapa kartu memori flash), masing-masing penyimpanan ini berjumlah sebagai perangkat semu terpisah. Namun, ketika bendera ini diatur, penyimpanan tidak terlihat sebagai perangkat, dan hanya perangkat yang terlihat sebagai perangkat. Lihat Keterangan untuk informasi selengkapnya. |
| ALLOW_OUTOFBAND_NOTIFICATION | Ketika bendera ini diatur, penyedia layanan dapat mengirim kedatangan dan penghapusan perangkat dengan mekanisme tambahan, seperti dengan menggunakan pesan jendela, serta mekanisme default untuk memanggil antarmuka IWMDMNotification yang diterapkan aplikasi. |
Nilai kembali
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Metode berhasil. |
|
Parameter fuPrefs menentukan nilai bit yang tidak didukung. |
|
Metode ini dipanggil setelah operasi enumerasi; harus dipanggil sebelum operasi enumerasi. |
Keterangan
Metode ini memberi klien kemampuan untuk mengambil alih perilaku enumerasi perangkat default Windows Media Device Manager. Untuk mengambil alih perilaku default, aplikasi klien harus memanggil metode ini segera setelah membuat objek manajer perangkat dengan mengkueri antarmuka IWMDMDeviceManager3 dari Media Device Manager. Panggilan harus dilakukan sebelum enumerasi terjadi, baik secara eksplisit maupun implisit sebagai akibat dari operasi lain.
Setelah bendera preferensi diatur, bendera tersebut tidak dapat diubah selama masa pakai aplikasi (bukan hanya masa pakai objek Windows Media Device Manager). Mencoba mengubah bendera preferensi akan mengakibatkan kesalahan. Memanggil metode ini lagi dengan pengaturan bendera yang sama tidak mengembalikan kesalahan, dan juga berpengaruh pada enumerasi.
Penyedia layanan mungkin tidak menghormati bendera DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES. Cara yang lebih kuat untuk menentukan apakah penyimpanan dihosting oleh perangkat yang sama adalah dengan memanggil IWMDMDevice2::GetCanonicalName. Penyimpanan dari perangkat yang sama akan mengembalikan nilai yang identik, kecuali untuk digit akhir setelah karakter "$" terakhir.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | mswmdm.h |