Fungsi WdfDeviceSetDeviceInterfaceState (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceSetDeviceInterfaceState mengaktifkan atau menonaktifkan antarmuka perangkat untuk perangkat tertentu.

Catatan

Driver seharusnya hanya memanggil fungsi ini setelah perangkat dimulai. Untuk mengubah status antarmuka dari penambahan perangkat, panggil WdfDeviceSetDeviceInterfaceStateEx sebagai gantinya.

Sintaks

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] InterfaceClassGUID

Pointer ke GUID yang mengidentifikasi kelas antarmuka perangkat.

[in, optional] ReferenceString

Penunjuk ke struktur UNICODE_STRING yang menjelaskan string referensi untuk antarmuka perangkat. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] IsInterfaceEnabled

Nilai Boolean yang, jika TRUE, mengaktifkan instans antarmuka perangkat yang ditentukan atau, jika FALSE, menonaktifkannya.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Untuk informasi selengkapnya tentang antarmuka perangkat dan metode WdfDeviceSetDeviceInterfaceState , lihat Menggunakan Antarmuka Perangkat.

Contoh

Contoh kode berikut menonaktifkan antarmuka port COM driver.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx