IPart::Activate method (devicetopology.h)

Metode Aktifkan mengaktifkan antarmuka khusus fungsi pada konektor atau subunit.

Sintaks

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

Parameter

[in] dwClsContext

Konteks eksekusi di mana kode yang mengelola objek yang baru dibuat akan berjalan. Pemanggil dapat membatasi konteks dengan mengatur parameter ini ke bitwise OR dari satu atau beberapa nilai enumerasi CLSCTX . Klien dapat menghindari pembatasan konteks apa pun dengan menentukan CLSCTX_ALL. Untuk informasi selengkapnya tentang CLSCTX, lihat dokumentasi Windows SDK.

[in] refiid

ID antarmuka untuk fungsi kontrol yang diminta. Klien harus mengatur parameter ini ke salah satu nilai REFIID berikut:

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

Untuk informasi selengkapnya, lihat Keterangan.

[out] ppvObject

Pointer ke variabel pointer tempat metode menulis alamat antarmuka yang ditentukan oleh parameter refiid. Melalui metode ini, pemanggil mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan Aktifkan gagal, *ppObject adalah NULL.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Bit CLSCTX_INPROC_SERVER dalam dwClsContext adalah nol.
E_POINTER	Pointer ppvObject adalah NULL.
E_NOINTERFACE	Objek bagian tidak mendukung antarmuka yang diminta.

Keterangan

Metode Aktifkan mendukung antarmuka kontrol khusus fungsi berikut:

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

Untuk mendapatkan ID antarmuka antarmuka kontrol khusus fungsi dari suatu bagian, panggil metode IControlInterface::GetIID bagian. Untuk mendapatkan ID antarmuka dari jenis antarmuka kontrol khusus fungsi, gunakan operator __uuidof . Misalnya, ID antarmuka IAudioAutoGainControl didefinisikan sebagai berikut:

const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Untuk informasi selengkapnya tentang operator __uuidof , lihat dokumentasi Windows SDK.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	devicetopology.h

Lihat juga

IControlInterface::GetIID

Antarmuka IPart