Función WdfDeviceSetDeviceState (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceSetDeviceState establece el estado del dispositivo para un dispositivo especificado.
Sintaxis
void WdfDeviceSetDeviceState(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_STATE DeviceState
);
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] DeviceState
Puntero a una estructura de WDF_DEVICE_STATE asignada por el controlador que contiene la información de estado del dispositivo.
Valor devuelto
Ninguno
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Cuando un controlador llama a WdfDeviceSetDeviceState, el marco notifica al administrador plug and play (PnP) que ha cambiado el estado del dispositivo.
Ejemplos
En el ejemplo de código siguiente se informa al administrador de PnP de que un dispositivo especificado está deshabilitado.
WDF_DEVICE_STATE deviceState;
WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
Device,
&deviceState
);
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) |