WdfDeviceSetPnpCapabilities-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

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

Syntax

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] PnpCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DEVICE_PNP_CAPABILITIES Struktur.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (wenn der Wert des PreviousState Parameters WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

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

Beispiele

In den folgenden Codebeispielen wird eine WDF_DEVICE_PNP_CAPABILITIES Struktur initialisiert und anschließend WdfDeviceSetPnpCapabilitiesaufgerufen.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

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

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

Freigeben über