Função WdfDeviceSetDeviceInterfaceState (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
O método WdfDeviceSetDeviceInterfaceState habilita ou desabilita uma interface do dispositivo para um dispositivo especificado.
Nota
O driver só deve chamar essa função depois que o dispositivo for iniciado. Para alterar o estado da interface da adição do dispositivo, chame WdfDeviceSetDeviceInterfaceStateEx.
Sintaxe
void WdfDeviceSetDeviceInterfaceState(
[in] WDFDEVICE Device,
[in] const GUID *InterfaceClassGUID,
[in, optional] PCUNICODE_STRING ReferenceString,
[in] BOOLEAN IsInterfaceEnabled
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] InterfaceClassGUID
Um ponteiro para um GUID que identifica a classe de interface do dispositivo.
[in, optional] ReferenceString
Um ponteiro para uma estrutura UNICODE_STRING que descreve uma cadeia de caracteres de referência para a interface do dispositivo. Esse parâmetro é opcional e pode ser NULL.
[in] IsInterfaceEnabled
Um valor booliano que, se TRUE, habilita a instância de interface do dispositivo especificada ou, se FALSE, a desabilita.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Para obter mais informações sobre interfaces de dispositivo e o método WdfDeviceSetDeviceInterfaceState, consulte Usando interfaces de dispositivo.
Exemplos
O exemplo de código a seguir desabilita a interface de porta COM de um driver.
WdfDeviceSetDeviceInterfaceState (
Device,
(LPGUID) &GUID_DEVINTERFACE_COMPORT,
NULL,
FALSE
);
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 | PASSIVE_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Consulte também
WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx