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

None

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 de 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	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfdevice.h (incluya 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_STATE_INIT