Função WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

Artigo
07/02/2025

O método WdfDeviceSetDeviceInterfaceStateEx habilita ou desabilita uma interface do 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.

Valor de retorno

Nenhum

Observações

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, EvtChildListCreateDeviceou EvtDevicePrepareHardware), o driver deve definir IsInterfaceEnabled como FALSE para impedir que a interface seja habilitada automaticamente durante a inicialização do PnP. A configuração do 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
de cliente com suporte mínimo	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

Consulte também

WdfDeviceSetDeviceInterfaceState

habilitar e desabilitar um de interface do dispositivo

Compartilhar via