Fungsi WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

  • Artikel

Metode WdfDeviceSetDeviceInterfaceStateEx memungkinkan atau menonaktifkan antarmuka perangkat untuk perangkat tertentu.

Sintaks

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

Parameter

Device

Handel ke objek perangkat kerangka kerja.

InterfaceClassGUID

Pointer ke GUID yang mengidentifikasi kelas antarmuka perangkat.

ReferenceString

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

IsInterfaceEnabled

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

Nilai kembali

Tidak ada

Keterangan

Driver dapat memanggil fungsi ini baik sebelum atau sesudah perangkat dimulai.

Ketika dipanggil sebelum perangkat dimulai (misalnya dari EvtDriverDeviceAdd, EvtChildListCreateDevice, atau EvtDevicePrepareHardware), driver harus mengatur IsInterfaceEnabled ke FALSE untuk mencegah antarmuka diaktifkan secara otomatis selama mulai PnP. Mengatur parameter ke TRUE sebelum perangkat dimulai redundan dan panggilan tersebut harus dihapus.

Saat memanggil setelah perangkat dimulai, perilakunya sama dengan WdfDeviceSetDeviceInterfaceState.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 2004
Versi KMDF minimum 1.31
Versi UMDF minimum 1.31
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL

Lihat juga

WdfDeviceSetDeviceInterfaceState

Mengaktifkan dan Menonaktifkan Antarmuka Perangkat