Função WdfDeviceSetDeviceState (wdfdevice.h)

Artigo
02/07/2025

[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

Requisito	Valor
da 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)

Consulte também

WDF_DEVICE_STATE_INIT

Compartilhar via