estructura de WDF_DEVICE_STATE (wdfdevice.h)

[Se aplica a KMDF y UMDF]

La estructura WDF_DEVICE_STATE especifica el estado Plug and Play de un dispositivo.

Sintaxis

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Disabled

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que el dispositivo está deshabilitado. Para obtener más información sobre el tipo de WDF_TRI_STATE , vea la sección Comentarios siguiente.

DontDisplayInUI

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que el dispositivo está oculto (no mostrado) en Administrador de dispositivos. Para obtener más información, consulte Visualización de dispositivos ocultos. (Después de establecer este miembro en WdfTrue, cambiar su valor no tiene ningún efecto).

Failed

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que el dispositivo está presente, pero que ha producido un error.

NotDisableable

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que el dispositivo no se puede deshabilitar.

Removed

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que se ha quitado el dispositivo.

ResourcesChanged

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que los requisitos de recursos del dispositivo han cambiado.

AssignedToGuest

Valor con tipo WDF_TRI_STATE que, si se establece en WdfTrue, indica que el dispositivo se notifica como asignado a una partición invitada.

Comentarios

Los miembros de la estructura usan el tipo WDF_TRI_STATE . Un valor de WdfUseDefault indica que el marco usará el valor proporcionado por un controlador inferior en la pila. Por ejemplo, si un controlador de bus especifica WdfTrue para NotDisableable y el controlador de función del dispositivo especifica WdfUseDefault, el marco usa WdfTrue para el estado del dispositivo.

La estructura WDF_DEVICE_STATE se usa como parámetro para WdfDeviceSetDeviceState y WdfDeviceGetDeviceState.

Para inicializar una estructura de WDF_DEVICE_STATE , el controlador debe llamar a WDF_DEVICE_STATE_INIT.

Para obtener más información sobre los miembros de la estructura de WDF_DEVICE_STATE , vea PNP_DEVICE_STATE.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfdevice.h (incluya Wdf.h)