Método IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda 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 um cadeia de caracteres nullterminada 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 habilitar; FALSE indica desabilitar.
Valor de retorno
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.
Observações
Se IWDFDevice::CreateDeviceInterface for bem-sucedida, a estrutura habilitará e desabilitará automaticamente a interface com base no estado PnP do dispositivo.
Use o método AssignDeviceInterfaceState para desabilitar e reabilitar manualmente uma interface do dispositivo.
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. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.5 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |