IControlInterface::Metode GetIID (devicetopology.h)

  • Artikel

Metode GetIID mendapatkan ID antarmuka dari antarmuka kontrol khusus fungsi dari bagian tersebut.

Sintaks

HRESULT GetIID(
  [out] GUID *pIID
);

Parameter

[out] pIID

Penunjuk ke variabel GUID tempat metode menulis ID antarmuka antarmuka antarmuka kontrol khusus fungsi dari bagian tersebut. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

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_POINTER
 Pointer pIID adalah NULL.

Keterangan

Objek yang mewakili bagian (konektor atau subunit) memiliki dua antarmuka kontrol. Yang pertama adalah antarmuka kontrol generik, IControlInterface, yang memiliki metode yang umum untuk semua jenis kontrol. Yang kedua adalah antarmuka kontrol khusus fungsi yang memiliki metode yang berlaku untuk jenis kontrol tertentu. Metode GetIID mendapatkan ID antarmuka antarmuka antarmuka kontrol kedua. Klien dapat memberikan ID antarmuka ini ke metode IPart::Activate untuk membuat instans antarmuka khusus fungsi bagian.

Metode ini mendapatkan salah satu ID antarmuka khusus fungsi yang diperlihatkan dalam tabel berikut.

ID Antarmuka Nama antarmuka
IID_IAudioAutoGainControl IAudioAutoGainControl
IID_IAudioBass IAudioBass
IID_IAudioChannelConfig IAudioChannelConfig
IID_IAudioInputSelector IAudioInputSelector
IID_IAudioLoudness IAudioLoudness
IID_IAudioMidrange IAudioMidrange
IID_IAudioMute IAudioMute
IID_IAudioOutputSelector IAudioOutputSelector
IID_IAudioPeakMeter IAudioPeakMeter
IID_IAudioTreble IAudioTreble
IID_IAudioVolumeLevel IAudioVolumeLevel
IID_IDeviceSpecificProperty IDeviceSpecificProperty
IID_IKsFormatSupport IKsFormatSupport
IID_IKsJackDescription IKsJackDescription
 

Untuk mendapatkan ID antarmuka antarmuka, gunakan operator __uuidof . Misalnya, ID antarmuka antarmuka antarmuka IAudioAutoGainControl didefinisikan sebagai berikut:


const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

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

Persyaratan

Persyaratan Nilai
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

Antarmuka IControlInterface