Função WdfDeviceSetDeviceState (wdfdevice.h)

[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.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece 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

Consulte também

WDF_DEVICE_STATE_INIT