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 |
---|---|
|
Bit CLSCTX_INPROC_SERVER dalam dwClsContext adalah nol. |
|
Pointer ppvObject adalah NULL. |
|
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
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
Saran dan Komentar
Kirim dan lihat umpan balik untuk