Função WdfDeviceSetDeviceState (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfDeviceSetDeviceState define o estado do dispositivo para um dispositivo especificado.

Sintaxe

void WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] DeviceState

Um ponteiro para uma estrutura de WDF_DEVICE_STATE alocada pelo driver que contém as informações de estado do dispositivo.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Quando um driver chama WdfDeviceSetDeviceState, a estrutura notifica o gerenciador de Plug and Play (PnP) de que o estado do dispositivo foi alterado.

Exemplos

O exemplo de código a seguir informa ao gerenciador PnP que um dispositivo especificado está desabilitado.

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_DEVICE_STATE_INIT