IPart::Metode GetSubType (devicetopology.h)

  • Artikel

Metode GetSubType mendapatkan subjenis bagian dari bagian ini.

Sintaks

HRESULT GetSubType(
  [out] GUID *pSubType
);

Parameter

[out] pSubType

Penunjuk ke variabel GUID tempat metode menulis GUID subjenis untuk bagian ini.

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

Keterangan

Metode ini biasanya mengambil salah satu nilai GUID KSNODETYPE_Xxx dari file header Ksmedia.h, meskipun beberapa driver kustom mungkin menyediakan nilai GUID lainnya. Untuk informasi selengkapnya tentang GUID KSNODETYPE_Xxx , lihat dokumentasi Windows DDK.

Seperti yang dijelaskan dalam Antarmuka IPart, bagian dapat berupa konektor atau subunit.

Untuk bagian yang merupakan konektor, metode ini mengambil GUID kategori pin yang telah ditetapkan driver ke konektor. Berikut ini adalah contoh GUID kategori pin:

  • KSNODETYPE_ANALOG_CONNECTOR, jika konektor adalah bagian dari jalur data ke atau dari perangkat analog seperti mikrofon atau speaker.
  • KSNODETYPE_SPDIF_INTERFACE, jika konektor adalah bagian dari jalur data ke atau dari port S/PDIF.
Untuk informasi selengkapnya, lihat diskusi properti kategori pin, KSPROPERTY_PIN_CATEGORY, dalam dokumentasi Windows DDK.

Untuk bagian yang merupakan subunit, metode ini mengambil GUID subjenis yang menunjukkan fungsi pemrosesan aliran yang dilakukan subunit. Misalnya, untuk subunit kontrol volume, metode mengambil nilai GUID KSNODETYPE_VOLUME.

Tabel berikut mencantumkan beberapa GUID subjenis yang dapat diambil oleh metode GetSubType untuk subunit.

GUID Subjenis Antarmuka kontrol Diperlukan atau opsional
KSNODETYPE_3D_EFFECTS IAudioChannelConfig Opsional
KSNODETYPE_AGC IAudioAutoGainControl Diperlukan
KSNODETYPE_DAC IAudioChannelConfig Opsional
KSNODETYPE_DEMUX IAudioOutputSelector Diperlukan
KSNODETYPE_DEV_SPECIFIC IDeviceSpecificProperty Diperlukan
KSNODETYPE_LOUDNESS IAudioLoudness Diperlukan
KSNODETYPE_MUTE IAudioMute Diperlukan
KSNODETYPE_MUX IAudioInputSelector Diperlukan
KSNODETYPE_PEAKMETER IAudioPeakMeter Diperlukan
KSNODETYPE_PROLOGIC_DECODER IAudioChannelConfig Opsional
KSNODETYPE_TONE IAudioBass

IAudioMidrange

IAudioTreble

 OpsionalOptional

Opsional
KSNODETYPE_VOLUME IAudioChannelConfig

IAudioVolumeLevel

 OptionalRequired
 

Dalam tabel sebelumnya, kolom tengah mencantumkan antarmuka kontrol yang didukung oleh subunit subjenis yang ditentukan di kolom kiri. Kolom kanan menunjukkan apakah dukungan subunit untuk antarmuka kontrol diperlukan atau opsional. Jika dukungan diperlukan, aplikasi dapat mengandalkan subunit subjenis yang ditentukan untuk mendukung antarmuka kontrol. Jika dukungan bersifat opsional, subunit subjenis yang ditentukan dapat, tetapi tidak selalu, mendukung antarmuka kontrol.

Antarmuka kontrol dalam tabel sebelumnya menyediakan akses mudah ke properti subunit. Namun, beberapa subunit memiliki properti yang tidak ada antarmuka kontrol yang sesuai. Aplikasi dapat mengakses properti ini melalui antarmuka IKsControl . Untuk informasi selengkapnya, lihat Menggunakan Antarmuka IKsControl untuk Mengakses Properti Audio.

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

Antarmuka IPart