estrutura WDF_DEVICE_STATE (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A estrutura WDF_DEVICE_STATE especifica o estado Plug and Play de um dispositivo.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Disabled

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo está desabilitado. Para obter mais informações sobre o tipo de WDF_TRI_STATE , consulte a seção Comentários a seguir.

DontDisplayInUI

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo está oculto (não exibido) no Gerenciador de Dispositivos. Para obter mais informações, consulte Exibindo dispositivos ocultos. (Depois de definir esse membro como WdfTrue, alterar seu valor não terá efeito.)

Failed

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo está presente, mas falhou.

NotDisableable

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo não pode ser desabilitado.

Removed

Um valor do tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo foi removido.

ResourcesChanged

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que os requisitos de recursos do dispositivo foram alterados.

AssignedToGuest

Um valor de tipo WDF_TRI_STATE que, se definido como WdfTrue, indica que o dispositivo está se reportando conforme atribuído a uma partição de convidado.

Comentários

Os membros da estrutura usam o tipo WDF_TRI_STATE . Um valor de WdfUseDefault indica que a estrutura usará o valor fornecido por um driver inferior na pilha. Por exemplo, se um driver de barramento especificar WdfTrue para NotDisable e o driver de função do dispositivo especificar WdfUseDefault, a estrutura usará WdfTrue para o estado do dispositivo.

A estrutura WDF_DEVICE_STATE é usada como um parâmetro para WdfDeviceSetDeviceState e WdfDeviceGetDeviceState.

Para inicializar uma estrutura de WDF_DEVICE_STATE , o driver deve chamar WDF_DEVICE_STATE_INIT.

Para obter mais informações sobre os membros da estrutura WDF_DEVICE_STATE , consulte PNP_DEVICE_STATE.

Requisitos

Requisito	Valor
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfdevice.h (inclua Wdf.h)