Función WdfDeviceSetPnpCapabilities (wdfdevice.h)

  • Artículo

[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:

Si más de un controlador de la pila de controladores del dispositivo llama a WdfDeviceSetPnpCapabilities, el administrador de Plug and Play usa los valores proporcionados por el controlador que es mayor en 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 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)

Consulte también

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities