Funzione WdfDeviceSetPnpCapabilities (wdfdevice.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceSetPnpCapabilities segnala le funzionalità di 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 nello stack di driver del dispositivo chiamano WdfDeviceSetPnpCapabilities, il gestore Plug and Play usa i valori forniti dal driver più alto nello stack.

Esempio

Gli esempi di codice seguenti inizializzano una struttura WDF_DEVICE_PNP_CAPABILITIES e quindi chiama WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

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

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	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)

Vedi anche

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

Condividi tramite