Función WdfDeviceSetPnpCapabilities (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceSetPnpCapabilities informa de las funcionalidades de Plug and Play de un dispositivo.
Sintaxis
void WdfDeviceSetPnpCapabilities(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] PnpCapabilities
Puntero a una estructura de WDF_DEVICE_PNP_CAPABILITIES asignada por el controlador.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Un controlador normalmente llama a WdfDeviceSetPnpCapabilities desde una de las siguientes funciones de devolución de llamada:
-
EvtDeviceD0Entry (si el valor del parámetro PreviousState es WdfPowerDeviceD3Final)
Ejemplos
En los ejemplos de código siguientes se inicializa una estructura de WDF_DEVICE_PNP_CAPABILITIES y, a continuación, se llama a WdfDeviceSetPnpCapabilities.
WDF_DEVICE_PNP_CAPABILITIES pnpCaps;
WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;
WdfDeviceSetPnpCapabilities(
device,
&pnpCaps
);
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Versión mínima de KMDF | 1.0 |
Versión mínima de UMDF | 2.0 |
Encabezado | wdfdevice.h (incluir Wdf.h) |
Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |