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

Lihat juga

IWDFDevice

IWDFDevice::AssignDeviceInterfaceState