Metode IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode AssignDeviceInterfaceState memungkinkan atau menonaktifkan instans antarmuka perangkat yang ditentukan untuk perangkat.
Sintaks
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
Parameter
[in] pDeviceInterfaceGuid
Pointer ke GUID untuk kelas antarmuka perangkat.
[in, optional] pReferenceString
Penunjuk ke string yang dihentikan NULL yang berisi nama instans antarmuka perangkat. Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak harus memberikan nama. Jika driver harus memberikan nama, string yang dilewati driver tidak boleh berisi karakter pemisah jalur ("/" atau "\").
[in] Enable
Nilai BOOL yang menentukan apakah instans antarmuka perangkat harus diaktifkan atau dinonaktifkan. TRUE menunjukkan untuk mengaktifkan; FALSE menunjukkan untuk menonaktifkan.
Mengembalikan nilai
AssignDeviceInterfaceState mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.
Keterangan
Jika IWDFDevice::CreateDeviceInterface berhasil, kerangka kerja secara otomatis mengaktifkan dan menonaktifkan antarmuka berdasarkan status PnP perangkat.
Gunakan metode AssignDeviceInterfaceState untuk menonaktifkan dan mengaktifkan kembali antarmuka perangkat secara manual.
Untuk informasi selengkapnya tentang antarmuka perangkat, lihat Menggunakan Antarmuka Perangkat di Driver UMDF.
Contoh
Untuk contoh kode tentang cara menggunakan metode AssignDeviceInterfaceState , lihat IWDFDevice::CreateDeviceInterface.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |