WdfDeviceSetPnpCapabilities-Funktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfDeviceSetPnpCapabilities-Methode meldet die Plug & Play Funktionen eines Geräts.

Syntax

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] PnpCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_PNP_CAPABILITIES-Struktur .

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Ein Treiber ruft in der Regel WdfDeviceSetPnpCapabilities aus einer der folgenden Rückruffunktionen auf:

Wenn mehrere Treiber im Treiberstapel des Geräts WdfDeviceSetPnpCapabilities aufrufen, verwendet der Plug & Play-Manager die Werte, die vom Treiber bereitgestellt werden, der am höchsten im Stapel ist.

Beispiele

Die folgenden Codebeispiele initialisieren eine WDF_DEVICE_PNP_CAPABILITIES-Struktur und rufen dann WdfDeviceSetPnpCapabilities auf.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

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

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities