Metodo IPart::Activate (devicetopology.h)

Il metodo Activate attiva un'interfaccia specifica della funzione in un connettore o subunit.

Sintassi

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

Parametri

[in] dwClsContext

Contesto di esecuzione in cui verrà eseguito il codice che gestisce l'oggetto appena creato. Il chiamante può limitare il contesto impostando questo parametro sull'or bit per bit di uno o più valori di enumerazione CLSCTX . Il client può evitare di imporre restrizioni di contesto specificando CLSCTX_ALL. Per altre informazioni su CLSCTX, vedere la documentazione di Windows SDK.

[in] refiid

ID interfaccia per la funzione di controllo richiesta. Il client deve impostare questo parametro su uno dei valori REFIID seguenti:

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

Per altre informazioni, vedere la sezione Osservazioni.

[out] ppvObject

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia specificata dal refiid del parametro. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata Attiva ha esito negativo, *ppObject è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_INVALIDARG	Il bit CLSCTX_INPROC_SERVER in dwClsContext è zero.
E_POINTER	Puntatore ppvObject è NULL.
E_NOINTERFACE	L'oggetto part non supporta l'interfaccia richiesta.

Commenti

Il metodo Activate supporta le interfacce di controllo specifiche della funzione seguenti:

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

Per ottenere l'ID interfaccia dell'interfaccia di controllo specifica della funzione di una parte, chiamare il metodo IControlInterface::GetIID della parte. Per ottenere l'ID dell'interfaccia di un tipo di interfaccia di controllo specifico della funzione, usare l'operatore __uuidof . Ad esempio, l'ID interfaccia di IAudioAutoGainControl è definito come segue:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Per altre informazioni sull'operatore __uuidof , vedere la documentazione di Windows SDK.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

IControlInterface::GetIID

Interfaccia IPart