Função SwDeviceInterfaceRegister (swdevice.h)

Artigo
06/27/2024

Registra uma interface de dispositivo para um dispositivo de software e, opcionalmente, define propriedades nessa interface.

Sintaxe

HRESULT SwDeviceInterfaceRegister(
  [in]            HSWDEVICE         hSwDevice,
  [in]            const GUID        *pInterfaceClassGuid,
  [in, optional]  PCWSTR            pszReferenceString,
  [in]            ULONG             cPropertyCount,
  [in, optional]  const DEVPROPERTY *pProperties,
  [in]            BOOL              fEnabled,
  [out, optional] PWSTR             *ppszDeviceInterfaceId
);

Parâmetros

[in] hSwDevice

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

[in] pInterfaceClassGuid

Um ponteiro para o GUID da classe de interface que nomeia o contrato que essa interface implementa.

[in, optional] pszReferenceString

Uma cadeia de caracteres de referência opcional que diferencia várias interfaces da mesma classe para este dispositivo. Esse ponteiro pode ser NULL.

[in] cPropertyCount

O número de estruturas de DEVPROPERTY na matriz pProperties .

[in, optional] pProperties

Uma matriz opcional de estruturas de DEVPROPERTY para as propriedades a serem definidas na interface. Esse ponteiro pode ser NULL.

Defina essas propriedades na interface depois que ela for criada, mas antes que uma notificação de que a interface foi criada seja enviada. Para obter mais informações, consulte Comentários. Esse ponteiro pode ser NULL.

[in] fEnabled

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

[out, optional] ppszDeviceInterfaceId

Um ponteiro para uma variável que recebe um ponteiro para a ID da interface do dispositivo para a interface. O chamador deve liberar esse valor com SwMemFree. Esse valor pode ser NULL se o aplicativo cliente não precisar recuperar o nome.

Valor de retorno

S_OK será retornado se SwDeviceInterfaceRegister registrou com êxito a interface; caso contrário, um valor de erro apropriado.

Observações

Você pode chamar SwDeviceInterfaceRegister 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ê não pode chamar SwDeviceInterfaceRegister para dispositivos de software que especificam a funcionalidade de SWDeviceCapabilitiesDriverRequired.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Universal
cabeçalho	swdevice.h
biblioteca	Swdevice.lib; OneCoreUAP.lib no Windows 10
de DLL	Cfgmgr32.dll

Consulte também

SwMemFree

Compartilhar via