Funzione WdfDeviceSetPnpCapabilities (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceSetPnpCapabilities segnala le funzionalità Plug and Play di un dispositivo.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] PnpCapabilities

Puntatore a una struttura di WDF_DEVICE_PNP_CAPABILITIES allocata dal driver.

Valore restituito

Nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Un driver chiama in genere WdfDeviceSetPnpCapabilities dall'interno di una delle funzioni di callback seguenti:

EvtDriverDeviceAdd
EvtDevicePrepareHardware
evtDeviceD0Entry (se il valore del parametro PreviousState è WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Se più driver nella chiamata dello stack di driver del dispositivo WdfDeviceSetPnpCapabilities, il gestore Plug and Play usa i valori forniti dal driver più alto nello stack.

Esempi

Negli esempi di codice seguenti viene inizializzata una struttura WDF_DEVICE_PNP_CAPABILITIES e quindi viene chiamato WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

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

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

Condividi tramite