struktur WDF_DEVICE_STATE (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_DEVICE_STATE menentukan status Plug and Play perangkat.

Sintaks

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Disabled

Nilai jenis WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat dinonaktifkan. Untuk informasi selengkapnya tentang jenis WDF_TRI_STATE , lihat bagian Keterangan berikut ini.

DontDisplayInUI

Nilai WDF_TRI_STATE-jenis yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat disembunyikan (tidak ditampilkan) di Manajer Perangkat. Untuk informasi selengkapnya, lihat Menampilkan Perangkat Tersembunyi. (Setelah Anda mengatur anggota ini ke WdfTrue, mengubah nilainya tidak berpengaruh.)

Failed

Nilai jenis WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat ada tetapi telah gagal.

NotDisableable

Nilai WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat tidak dapat dinonaktifkan.

Removed

Nilai WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat telah dihapus.

ResourcesChanged

Nilai WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa persyaratan sumber daya perangkat telah berubah.

AssignedToGuest

Nilai yang ditik WDF_TRI_STATE yang, jika diatur ke WdfTrue, menunjukkan bahwa perangkat melaporkan dirinya sebagaimana ditetapkan ke partisi tamu.

Keterangan

Anggota struktur menggunakan jenis WDF_TRI_STATE . Nilai WdfUseDefault menunjukkan kerangka kerja akan menggunakan nilai yang disediakan oleh driver yang lebih rendah di tumpukan. Misalnya, jika driver bus menentukan WdfTrue untuk NotDisable dan driver fungsi perangkat menentukan WdfUseDefault, kerangka kerja menggunakan WdfTrue untuk status perangkat.

Struktur WDF_DEVICE_STATE digunakan sebagai parameter untuk WdfDeviceSetDeviceState dan WdfDeviceGetDeviceState.

Untuk menginisialisasi struktur WDF_DEVICE_STATE , driver harus memanggil WDF_DEVICE_STATE_INIT.

Untuk informasi selengkapnya tentang anggota struktur WDF_DEVICE_STATE , lihat PNP_DEVICE_STATE.

Persyaratan

Persyaratan Nilai
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)