Método IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)

  • Artigo

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método AssignDeviceInterfaceState habilita ou desabilita a instância de interface do dispositivo especificada para um dispositivo.

Sintaxe

HRESULT AssignDeviceInterfaceState(
  [in]           LPCGUID pDeviceInterfaceGuid,
  [in, optional] PCWSTR  pReferenceString,
  [in]           BOOL    Enable
);

Parâmetros

[in] pDeviceInterfaceGuid

Um ponteiro para o GUID para uma classe de interface do dispositivo.

[in, optional] pReferenceString

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome da instância da interface do dispositivo. Esse parâmetro é opcional. O driver poderá passar NULL se o driver não precisar fornecer um nome. Se o driver precisar fornecer um nome, a cadeia de caracteres que o driver passa não deverá conter caracteres separadores de caminho ("/" ou "\").

[in] Enable

Um valor BOOL que especifica se a instância da interface do dispositivo deve ser habilitada ou desabilitada. TRUE indica para habilitar; FALSE indica para desabilitar.

Retornar valor

AssignDeviceInterfaceState retornará S_OK se a operação for bem-sucedida. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.

Comentários

Se IWDFDevice::CreateDeviceInterface for bem-sucedido, a estrutura habilitará e desabilita automaticamente a interface com base no estado PnP do dispositivo.

Use o método AssignDeviceInterfaceState para desabilitar e reabilitar uma interface do dispositivo manualmente.

Para obter mais informações sobre interfaces de dispositivo, consulte Usando interfaces de dispositivo em drivers UMDF.

Exemplos

Para obter um exemplo de código de como usar o método AssignDeviceInterfaceState , consulte IWDFDevice::CreateDeviceInterface.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

IWDFDevice

IWDFDevice::CreateDeviceInterface