Fungsi WdfDeviceInitSetExclusive (wdfdevice.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfDeviceInitSetExclusive menunjukkan apakah perangkat tertentu adalah perangkat eksklusif.

Sintaks

void WdfDeviceInitSetExclusive(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] BOOLEAN         IsExclusive
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

[in] IsExclusive

Nilai Boolean yang, jika TRUE, menunjukkan bahwa perangkat adalah perangkat eksklusif. Jika FALSE, perangkat bukan perangkat eksklusif.

Nilai kembali

Tidak ada

Keterangan

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

Jika driver memanggil WdfDeviceInitSetExclusive, hanya objek perangkat driver tersebut yang eksklusif. Untuk membuat seluruh tumpukan perangkat menjadi eksklusif, file INF perangkat harus menyertakan direktif INF AddReg yang mengatur entri Eksklusif ke TRUE dalam registri.

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

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

Contoh

Contoh kode berikut menunjukkan bahwa perangkat adalah perangkat eksklusif.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

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), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Lihat juga

EvtDriverDeviceAdd

WdfDeviceBuat