Método IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[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 |