Função WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

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

Sintaxe

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

Parâmetros

Device

Um identificador para um objeto de dispositivo de estrutura.

InterfaceClassGUID

Um ponteiro para um GUID que identifica a classe de interface do dispositivo.

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.

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

O driver pode chamar essa função antes ou depois que o dispositivo for iniciado.

Quando chamado antes do dispositivo ser iniciado (por exemplo, de EvtDriverDeviceAdd, EvtChildListCreateDevice ou EvtDevicePrepareHardware), o driver deve definir IsInterfaceEnabled como FALSE para impedir que a interface seja habilitada automaticamente durante a inicialização do PnP. Definir o parâmetro como TRUE antes do dispositivo ser iniciado é redundante e essa chamada deve ser removida.

Ao chamar depois que o dispositivo é iniciado, o comportamento é o mesmo que WdfDeviceSetDeviceInterfaceState.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 2004
Versão mínima do KMDF	1.31
Versão mínima do UMDF	1.31
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Confira também

WdfDeviceSetDeviceInterfaceState

Habilitar e desabilitar uma interface do dispositivo