Fungsi WdfDeviceInitSetDeviceType (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceInitSetDeviceType mengatur jenis perangkat untuk perangkat tertentu.

Sintaks

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

[in] DeviceType

Nilai FILE_DEVICE_XXXX yang mengidentifikasi jenis perangkat. Untuk informasi selengkapnya tentang nilai FILE_DEVICE_XXXX, lihat Menentukan Jenis Perangkat.

Nilai kembali

Tidak ada

Keterangan

Jika driver memanggil WdfDeviceInitSetDeviceType, driver harus melakukannya sebelum memanggil WdfDeviceCreate.

Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Jenis perangkat yang ditentukan driver menentukan nilai peningkatan prioritas default yang digunakan kerangka kerja saat driver menyelesaikan permintaan I/O. Untuk informasi selengkapnya tentang nilai peningkatan prioritas, lihat Menentukan Peningkatan Prioritas Saat Menyelesaikan Permintaan I/O.

Jika Anda menulis driver UMDF, Anda harus mengubah file INF driver Anda atau membuat perubahan registri untuk menentukan jenis perangkat. Untuk informasi selengkapnya tentang menggunakan registri, lihat Mengatur Properti Registri Objek Perangkat Selama Penginstalan.

Contoh

Contoh kode berikut menunjukkan bahwa perangkat adalah perangkat serial.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)