Fungsi WdfDeviceSetPnpCapabilities (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceSetPnpCapabilities melaporkan kemampuan Plug and Play perangkat.

Sintaks

void WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] PnpCapabilities

Penunjuk ke struktur WDF_DEVICE_PNP_CAPABILITIES yang dialokasikan driver.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Driver biasanya memanggil WdfDeviceSetPnpCapabilities dari dalam salah satu fungsi panggilan balik berikut:

Jika lebih dari satu driver dalam tumpukan driver perangkat memanggil WdfDeviceSetPnpCapabilities, manajer Plug and Play menggunakan nilai yang disediakan oleh driver yang tertinggi dalam tumpukan.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_DEVICE_PNP_CAPABILITIES lalu memanggil WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities