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
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) |