IPart::GetControlInterface method (devicetopology.h)

Artikel
08/23/2023

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

Sintaks

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Parameter

[in] nIndex

Nomor antarmuka kontrol. Jika bagian mendukung antarmuka kontrol n , antarmuka kontrol diberi nomor dari 0 hingga n– 1.

[out] ppInterfaceDesc

Pointer ke variabel pointer tempat metode menulis alamat antarmuka IControlInterface dari fungsi audio yang ditentukan. Melalui metode ini, penelepon mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetControlInterface gagal, *ppFunction adalah NULL.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_POINTER	Pointer ppFunction adalah NULL.
E_INVALIDARG	Parameter nIndex berada di luar rentang.
E_NOTFOUND	Bagian tidak memiliki antarmuka kontrol.

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 IControlInterface

Antarmuka IPart

Bagikan melalui