Antarmuka IPart (devicetopology.h)

  • Artikel

Antarmuka IPart mewakili bagian (konektor atau subunit) dari topologi perangkat. Klien mendapatkan referensi ke antarmuka IPart dengan memanggil metode IDeviceTopology::GetPartById atau IPartsList::GetPart , atau dengan memanggil metode QueryInterface antarmuka IConnector atau ISubunit pada objek bagian dan mengatur parameter iid metode ke REFIID IID_IPart.

Objek dengan antarmuka IPart dapat merangkum salah satu bagian topologi perangkat berikut:

  • Konektor. Ini adalah bagian yang terhubung ke perangkat lain untuk membentuk jalur data untuk mengirimkan aliran audio antar perangkat.
  • Subunit. Ini adalah bagian yang memproses aliran audio (misalnya, kontrol volume).
Antarmuka IPart dari objek konektor atau subunit mewakili fungsi generik yang umum untuk semua bagian, dan antarmuka IConnector atau ISubunit objek mewakili fungsi yang khusus untuk konektor atau subunit. Selain itu, bagian mungkin mendukung satu atau beberapa antarmuka kontrol untuk mengontrol atau memantau fungsi bagian. Misalnya, klien mengontrol subunit kontrol volume melalui antarmuka IAudioVolumeLevel-nya .

Antarmuka IPart menyediakan metode untuk mendapatkan nama, ID lokal, ID global, dan jenis bagian konektor atau subunit. Selain itu, IPart dapat mengaktifkan antarmuka kontrol pada konektor atau subunit.

Untuk contoh kode yang menggunakan antarmuka IPart , lihat implementasi fungsi GetHardwareDeviceTopology dan SelectCaptureDevice di Topologi Perangkat.

Warisan

Antarmuka IPart mewarisi dari antarmuka IUnknown . IPart juga memiliki jenis anggota ini:

Metode

Antarmuka IPart memiliki metode ini.

 
IPart::Activate

Metode Aktifkan mengaktifkan antarmuka khusus fungsi pada konektor atau subunit.
IPart::EnumPartsIncoming

Metode EnumPartsIncoming mendapatkan daftar semua bagian masuk yaitu, bagian yang berada di jalur data yang upstream dari bagian ini.
IPart::EnumPartsOutgoing

Metode EnumPartsOutgoing mengambil daftar semua bagian keluar yaitu, bagian yang berada di jalur data yang hilir dari bagian ini.
IPart::GetControlInterface

Metode GetControlInterface mendapatkan referensi ke antarmuka kontrol yang ditentukan, jika bagian ini mendukungnya.
IPart::GetControlInterfaceCount

Metode GetControlInterfaceCount mendapatkan jumlah antarmuka kontrol yang didukung bagian ini.
IPart::GetglobalId

Metode GetGlobalId mendapatkan ID global dari bagian ini.
IPart::GetLocalId

Metode GetLocalId mendapatkan ID lokal dari bagian ini.
IPart::GetName

Metode GetName mendapatkan nama yang mudah diingat dari bagian ini.
IPart::GetPartType

Metode GetPartType mendapatkan jenis bagian dari bagian ini.
IPart::GetSubType

Metode GetSubType mendapatkan subjenis bagian dari bagian ini.
IPart::GetTopologyObject

Metode GetTopologyObject mendapatkan referensi ke antarmuka IDeviceTopology dari objek topologi perangkat yang berisi bagian ini.
IPart::RegisterControlChangeCallback

Metode RegisterControlChangeCallback mendaftarkan antarmuka IControlChangeNotify, yang diterapkan klien untuk menerima pemberitahuan perubahan status di bagian ini.
IPart::UnregisterControlChangeCallback

Metode UnregisterControlChangeCallback menghapus pendaftaran antarmuka IControlChangeNotify yang sebelumnya didaftarkan klien melalui panggilan ke metode IPart::RegisterControlChangeCallback.

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 Audio Inti

DeviceTopology API

Antarmuka IAudioVolumeLevel

Antarmuka IConnector

IDeviceTopology::GetPartById

IPartsList::GetPart

Antarmuka ISubunit