Fungsi WdfDeviceSetDeviceState (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceSetDeviceState mengatur status perangkat untuk perangkat tertentu.

Sintaks

void WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] DeviceState

Penunjuk ke struktur WDF_DEVICE_STATE yang dialokasikan driver yang berisi informasi status perangkat.

Nilai kembali

Tidak ada

Keterangan

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

Ketika driver memanggil WdfDeviceSetDeviceState, kerangka kerja memberi tahu manajer Plug and Play (PnP) bahwa status perangkat telah berubah.

Contoh

Contoh kode berikut memberi tahu manajer PnP bahwa perangkat tertentu dinonaktifkan.

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

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 <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_DEVICE_STATE_INIT