Função WdfDeviceSetDeviceInterfaceState (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceSetDeviceInterfaceState habilita ou desabilita uma interface de dispositivo para um dispositivo especificado.

Observação

O driver só deve chamar essa função depois que o dispositivo for iniciado. Para alterar o estado da interface do dispositivo adicionar, 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.

Retornar valor

Nenhum

Comentários

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

Para obter mais informações sobre interfaces de dispositivo e o método WdfDeviceSetDeviceInterfaceState , confira 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
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)

Confira também

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx