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

Confira também

WdfDeviceSetDeviceInterfaceState

Habilitar e desabilitar uma interface do dispositivo