IPart::GetControlInterface method (devicetopology.h)
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 |
---|---|
|
Pointer ppFunction adalah NULL. |
|
Parameter nIndex berada di luar rentang. |
|
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 |