estructura 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 de tipo WDF_TRI_STATEque, 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 siguiente sección Comentarios.

DontDisplayInUI

Valor de tipo WDF_TRI_STATEque, si se establece en WdfTrue, indica que el dispositivo está oculto (no mostrado) en el 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

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

NotDisableable

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

Removed

Valor de tipo WDF_TRI_STATEque, si se establece en WdfTrue, indica que se ha quitado el dispositivo.

ResourcesChanged

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

AssignedToGuest

Valor de tipo WDF_TRI_STATEque, si se establece en WdfTrue, indica que el dispositivo se informa a sí mismo como asignado a una partición de invitado.

Observaciones

Los miembros de la estructura usan el tipo de WDF_TRI_STATE. Un valor de WdfUseDefault indica que el marco usará el valor proporcionado por un controlador inferior de la pila. Por ejemplo, si un controlador de bus especifica WdfTrue para NotDisableable y el controlador de funciones 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	Valor
versión mínima de KMDF	1.0
versión mínima de UMDF	2.0
encabezado	wdfdevice.h (incluya Wdf.h)