struktur WDF_DEVICE_PNP_CAPABILITIES (wdfdevice.h)

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_DEVICE_PNP_CAPABILITIES menjelaskan kemampuan Plug and Play perangkat.

Sintaks

typedef struct _WDF_DEVICE_PNP_CAPABILITIES {
  ULONG         Size;
  WDF_TRI_STATE LockSupported;
  WDF_TRI_STATE EjectSupported;
  WDF_TRI_STATE Removable;
  WDF_TRI_STATE DockDevice;
  WDF_TRI_STATE UniqueID;
  WDF_TRI_STATE SilentInstall;
  WDF_TRI_STATE SurpriseRemovalOK;
  WDF_TRI_STATE HardwareDisabled;
  WDF_TRI_STATE NoDisplayInUI;
  ULONG         Address;
  ULONG         UINumber;
} WDF_DEVICE_PNP_CAPABILITIES, *PWDF_DEVICE_PNP_CAPABILITIES;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

LockSupported

Nilai WDF_TRI_STATE-jenis yang menunjukkan, jika diatur ke WdfTrue, bahwa perangkat dapat dikunci di slotnya untuk mencegah ejeksi. (Kemampuan ini menonaktifkan mengeluarkan perangkat dari slotnya, bukan mengeluarkan media dari perangkat.) Untuk informasi selengkapnya tentang nilai yang ditik WDF_TRI_STATE, lihat bagian Keterangan berikut ini.

EjectSupported

Nilai jenis WDF_TRI_STATE yang menunjukkan, jika diatur ke WdfTrue, bahwa perangkat dapat dikeluarkan dari slotnya. (Kemampuan ini memungkinkan mengeluarkan perangkat dari slotnya, tidak mengeluarkan media dari perangkat.)

Removable

Nilai WDF_TRI_STATE-ketik yang menunjukkan, jika diatur ke WdfTrue, bahwa perangkat dapat dihapus saat sistem berjalan. Jika Removable diatur ke WdfTrue dan SurpriseRemovalOK diatur ke WdfFalse, pengguna harus menggunakan program Unplug atau Eject Hardware sistem.

DockDevice

Nilai yang diketik WDF_TRI_STATE yang menunjukkan, jika diatur ke WdfTrue, bahwa perangkat adalah stasiun docking.

UniqueID

Nilai jenis WDF_TRI_STATE yang menunjukkan, jika diatur ke WdfTrue, bahwa ID instans perangkat unik untuk seluruh sistem. Jika UniqueID diatur ke WdfFalse, ID instans hanya unik untuk bus perangkat. Untuk informasi selengkapnya tentang ID instans, lihat String Identifikasi Perangkat.

SilentInstall

Nilai WDF_TRI_STATE-ketik yang menunjukkan, jika diatur ke WdfTrue, Manajer Perangkat tersebut tidak boleh menampilkan kotak dialog selama penginstalan perangkat.

SurpriseRemovalOK

Nilai jenis WDF_TRI_STATE yang menunjukkan, jika diatur ke WdfTrue (dan jika Dapat Dilepas juga diatur ke WdfTrue), pengguna dapat menghapus perangkat tanpa menggunakan program Cabut atau Lepaskan Perangkat Keras sistem.

HardwareDisabled

Nilai WDF_TRI_STATE-jenis yang menunjukkan, jika diatur ke WdfTrue, bahwa perangkat dinonaktifkan.

NoDisplayInUI

Nilai jenis WDF_TRI_STATE yang menunjukkan, jika diatur ke WdfTrue, Manajer Perangkat tersebut tidak boleh menampilkan perangkat.

Address

Alamat yang menunjukkan di mana perangkat berada di busnya.

Interpretasi nomor ini khusus bus. Jika alamat tidak diketahui atau pengemudi bus tidak mendukung alamat, pengemudi bus meninggalkan anggota Alamat pada nilai default 0xFFFFFFFF (-1).

Daftar berikut ini menjelaskan informasi yang disimpan driver bus tertentu di anggota Alamat untuk perangkat anak mereka:

Bus	Deskripsi
1394	Tidak menyediakan alamat karena alamatnya volatil. Default ke 0xFFFFFFFF.
EISA	Nomor Slot (0-F).
IDE	Untuk perangkat IDE, alamat berisi ID target dan LUN. Untuk saluran IDE, alamatnya adalah nol atau satu (0 = saluran utama dan 1 = saluran sekunder).
ISApnp	Tidak menyediakan alamat. Default ke 0xFFFFFFFF.
Kartu PC (PCMCIA)	Nomor soket (biasanya 0x00 atau 0x40).
PCI	Nomor perangkat dalam kata tinggi dan nomor fungsi dalam kata rendah.
SCSI	ID target.
USB	Nomor port.

UINumber

Angka yang terkait dengan perangkat dan dapat ditampilkan di antarmuka pengguna. Nomor ini biasanya merupakan nomor slot yang dirasakan pengguna, seperti angka yang dicetak di samping slot di papan atau beberapa nomor lain yang membantu pengguna menemukan perangkat. Jika UINumber tidak diketahui, atau jika memasok angka tidak akan membantu pengguna dalam mengidentifikasi lokasi perangkat, driver menetapkan nilai ini ke -1.

Keterangan

Beberapa anggota menggunakan jenis WDF_TRI_STATE . Untuk anggota ini, nilai WdfTrue menunjukkan bahwa perangkat mendukung kemampuan dan nilai WdfFalse menunjukkan tidak. Nilai WdfUseDefault menunjukkan kerangka kerja akan menggunakan nilai yang lebih rendah driver dalam tumpukan yang disediakan. Misalnya, jika driver bus menentukan WdfTrue untuk LockSupported dan driver fungsi perangkat menentukan WdfUseDefault, kerangka kerja menyimpan WdfTrue untuk kemampuan tersebut.

Struktur WDF_DEVICE_PNP_CAPABILITIES digunakan sebagai input ke WdfDeviceSetPnpCapabilities.

Untuk menginisialisasi struktur WDF_DEVICE_PNP_CAPABILITIES, driver harus memanggil WDF_DEVICE_PNP_CAPABILITIES_INIT.

Persyaratan

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

Lihat juga

WdfDeviceSetPowerCapabilities

WdfPdoInitAssignRawDevice