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