Función WdfDeviceSetPnpCapabilities (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceSetPnpCapabilities informa de las funcionalidades 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
Ninguno
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Normalmente, un controlador llama a WdfDeviceSetPnpCapabilities desde una de las siguientes funciones de devolución de llamada:
Si hay más de un controlador en la llamada de pila de controladores del dispositivo WdfDeviceSetPnpCapabilities, el administrador plug and Play usa los valores proporcionados por el controlador que es el más alto de la pila.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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |