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) |