Método IPart::GetControlInterface (devicetopology.h)

  • Artigo

O método GetControlInterface obtém uma referência à interface de controle especificada, se essa parte der suporte a ela.

Sintaxe

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Parâmetros

[in] nIndex

O número da interface de controle. Se uma parte der suporte a n interfaces de controle, as interfaces de controle serão numeradas de 0 a n– 1.

[out] ppInterfaceDesc

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IControlInterface da função de áudio especificada. Por meio desse método, o chamador obtém uma referência contada para a interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetControlInterface falhar, *ppFunction seráNULL.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
 O ponteiro ppFunction é NULL.
E_INVALIDARG
 O parâmetro nIndex está fora do intervalo.
E_NOTFOUND
 A parte não tem uma interface de controle.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IControlInterface Interface

IPart Interface