IAudioSystemEffectsCustomFormats::Metode GetFormatRepresentation (audioenginebaseapo.h)
Metode ini GetFormatRepresentation
mengambil representasi string dari format kustom sehingga dapat ditampilkan pada antarmuka pengguna.
Sintaks
HRESULT GetFormatRepresentation(
[in] UINT nFormat,
[out, optional] LPWSTR *ppwstrFormatRep
);
Parameter
[in] nFormat
Menentukan indeks format yang didukung. Parameter ini dapat berupa nilai apa pun dalam rentang dari nol hingga satu kurang dari nilai yang dikembalikan getFormatCount. Dengan kata lain, nilai apa pun dalam rentang dari nol hingga GetFormatCount( ) - 1.
[out, optional] ppwstrFormatRep
Menentukan alamat buffer yang menerima string Unicode yang dihentikan NULL yang menjelaskan format kustom.
Menampilkan nilai
Metode GetFormatRepresentation
mengembalikan S_OK ketika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan salah satu kode kesalahan yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Penunjuk tidak valid diteruskan ke fungsi |
|
Buffer pengembalian tidak dapat dialokasikan |
|
nFormat di luar rentang |
Keterangan
SAPO menggunakan CoTaskMemAlloc untuk mengalokasikan string yang dikembalikan. Pemanggil harus menggunakan CoTaskMemFree untuk menghapus buffer yang diarahkan oleh parameter ppwstrFormatRep .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows Vista dan versi Windows yang lebih baru. |
Target Platform | Desktop |
Header | audioenginebaseapo.h (termasuk Audioenginebaseapo.h) |
IRQL | Semua tingkatan. |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk