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

O método Activate ativa uma interface específica de função em um conector ou subunidade.

Sintaxe

HRESULT Activate(
  [in]  DWORD  dwClsContext,
  [in]  REFIID refiid,
  [out] void   **ppvObject
);

Parâmetros

[in] dwClsContext

O contexto de execução no qual o código que gerencia o objeto recém-criado será executado. O chamador pode restringir o contexto definindo esse parâmetro para o OR bit a bit de um ou mais valores de enumeração CLSCTX . O cliente pode evitar impor restrições de contexto especificando CLSCTX_ALL. Para obter mais informações sobre CLSCTX, consulte a documentação do SDK do Windows.

[in] refiid

A ID da interface da função de controle solicitada. O cliente deve definir esse parâmetro como um dos seguintes valores REFIID :

IID_IAudioAutoGainControl

IID_IAudioBass

IID_IAudioChannelConfig

IID_IAudioInputSelector

IID_IAudioLoudness

IID_IAudioMidrange

IID_IAudioMute

IID_IAudioOutputSelector

IID_IAudioPeakMeter

IID_IAudioTreble

IID_IAudioVolumeLevel

IID_IDeviceSpecificProperty

IID_IKsFormatSupport

IID_IKsJackDescription

IID_IKsJackDescription2

Para obter mais informações, consulte Comentários.

[out] ppvObject

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface especificada pelo parâmetro refiid. Por meio desse método, o chamador obtém uma referência contada à 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 Ativar falhar, *ppObject 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_INVALIDARG	O bit CLSCTX_INPROC_SERVER em dwClsContext é zero.
E_POINTER	O ponteiro ppvObject é NULL.
E_NOINTERFACE	O objeto part não dá suporte à interface solicitada.

Comentários

O método Activate dá suporte às seguintes interfaces de controle específicas da função:

• IAudioAutoGainControl
• IAudioBass
• IAudioChannelConfig
• IAudioInputSelector
• IAudioLoudness
• IAudioMidrange
• IAudioMute
• IAudioOutputSelector
• IAudioPeakMeter
• IAudioTreble
• IAudioVolumeLevel
• IDeviceSpecificProperty
• IKsFormatSupport
• IKsJackDescription
• IKsJackDescription2

Para obter a ID da interface de controle específica da função de uma parte, chame o método IControlInterface::GetIID da parte. Para obter a ID da interface de um tipo de interface de controle específico da função, use o operador __uuidof . Por exemplo, a ID da interface de IAudioAutoGainControl é definida da seguinte maneira:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Para obter mais informações sobre o operador __uuidof , consulte a documentação do SDK do Windows.

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::GetIID

IPart Interface