Metode IWDFDevice::CreateDeviceInterface (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 CreateDeviceInterface membuat instans kelas antarmuka perangkat.
Sintaks
HRESULT CreateDeviceInterface(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString
);
Parameter
[in] pDeviceInterfaceGuid
Penunjuk 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 apa pun ("/" atau "\").
Mengembalikan nilai
CreateDeviceInterface mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.
Keterangan
Driver dapat menggunakan parameter pReferenceString untuk membedakan instans yang berbeda dari satu antarmuka. Dengan kata lain, jika driver memanggil CreateDeviceInterface dua kali untuk kelas antarmuka perangkat yang sama, driver dapat menentukan string yang berbeda untuk pReferenceString setiap kali. Saat instans antarmuka dibuka, kerangka kerja meneruskan string referensi instans ke driver. String referensi ditambahkan ke komponen jalur nama instans antarmuka. Driver kemudian dapat menggunakan string referensi untuk menentukan instans kelas antarmuka perangkat mana yang sedang dibuka.
Jika CreateDeviceInterface berhasil, status awal antarmuka dinonaktifkan. Jika pembuatan berhasil, kerangka kerja secara otomatis mengaktifkan dan menonaktifkan antarmuka berdasarkan status PnP perangkat. Selain itu, driver dapat menonaktifkan dan mengaktifkan kembali antarmuka perangkat seperlunya dengan memanggil IWDFDevice::AssignDeviceInterfaceState.
Untuk informasi selengkapnya tentang antarmuka perangkat, lihat Menggunakan Antarmuka Perangkat di Driver berbasis UMDF.
Contoh
Contoh kode berikut menunjukkan cara membuat instans antarmuka perangkat. Dalam contoh ini, driver secara eksplisit memanggil IWDFDevice::AssignDeviceInterfaceState untuk mengaktifkan antarmuka.
//
// Create the device interface.
//
HRESULT hr;
if (S_OK == hr) {
hr = m_FxDevice->CreateDeviceInterface(
&GUID_DEVINTERFACE_OSRUSBFX2,
NULL);
}
if (S_OK == hr) {
hr = m_FxDevice->AssignDeviceInterfaceState(
&GUID_DEVINTERFACE_OSRUSBFX2,
NULL,
TRUE);
}
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 |