Compartilhar via

Função SwDeviceInterfaceSetState (swdevice.h)

  • Artigo

Habilita ou desabilita uma interface de dispositivo para um dispositivo de software.

Sintaxe

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

Parâmetros

[in] hSwDevice

O identificador HSWDEVICE para o dispositivo de software para o qual registrar uma interface de dispositivo.

[in] pszDeviceInterfaceId

Uma cadeia de caracteres que identifica a interface para habilitar ou desabilitar.

[in] fEnabled

Um valor booliano que indica se a interface deve ser habilitada ou desabilitada. TRUE para habilitar; FALSE para desabilitar.

Retornar valor

S_OK será retornado se SwDeviceInterfaceSetState tiver habilitado ou desabilitado a interface com êxito; caso contrário, um valor de erro apropriado.

Comentários

Você pode chamar SwDeviceInterfaceSetState somente depois que o sistema operacional tiver chamado a função de retorno de chamada SW_DEVICE_CREATE_CALLBACK do aplicativo cliente para notificar o aplicativo cliente de que a enumeração do dispositivo foi concluída.

Você só pode usar SwDeviceInterfaceSetState para gerenciar interfaces que foram registradas anteriormente com SwDeviceInterfaceRegister no dispositivo de software que hSwDevice representa.

Os aplicativos cliente usam SwDeviceInterfaceSetState para gerenciar o estado que eles desejam que a interface tenha. O dispositivo de software altera o estado real da interface conforme necessário. Por exemplo, um aplicativo cliente desabilita e reabilita a interface se o dispositivo é renumerado por qualquer motivo. O estado sempre tenta refletir o estado necessário do aplicativo cliente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Universal
Cabeçalho swdevice.h
Biblioteca Swdevice.lib; OneCoreUAP.lib no Windows 10
DLL Cfgmgr32.dll