Metode IKsFormatSupport::GetDevicePreferredFormat (devicetopology.h)
Metode GetDevicePreferredFormat mendapatkan format aliran audio pilihan untuk koneksi.
Sintaks
HRESULT GetDevicePreferredFormat(
[out] PKSDATAFORMAT *ppKsFormat
);
Parameter
[out] ppKsFormat
Penunjuk ke variabel penunjuk tempat metode menulis alamat buffer yang berisi penentu format untuk format pilihan. Penentu dimulai dengan struktur KSDATAFORMAT yang mungkin diikuti oleh informasi format tambahan. Metode mengalokasikan penyimpanan untuk penentu format. Pemanggil bertanggung jawab untuk membebaskan penyimpanan, ketika tidak lagi diperlukan, dengan memanggil fungsi CoTaskMemFree . Jika metode gagal, *ppKsFormat adalah NULL. Untuk informasi selengkapnya tentang KSDATAFORMAT, penentu format, dan CoTaskMemFree, lihat dokumentasi Windows DDK.
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 ppKsFormat adalah NULL. |
|
Kehabisan memori. |
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 |