Metode IApoAuxiliaryInputConfiguration::IsInputFormatSupported (audioenginebaseapo.h)

Memverifikasi bahwa format input tambahan tertentu didukung oleh APO.

Sintaks

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

Parameter

pRequestedInputFormat

Format input yang akan diverifikasi.

ppSupportedInputFormat

APO mengisi parameter ini dengan format input yang didukung paling dekat dengan format yang diteruskan ke metode .

Menampilkan nilai

HRESULT

HRESULT	Deskripsi
S_OK	Penyelesaian berhasil. APO harus menambahkan referensi ke pRequestedInputFormat dan mengembalikannya di ppSupportedInputFormat
S_FALSE	Format tidak didukung. APO harus mengembalikan format yang didukung yang disarankan dalam ppSupportedInputFormat
APOERR_FORMAT_NOT_SUPPORTED	Format tidak didukung. APO tidak boleh mengubah ppSupportedInputFormat
E_POINTER	Penunjuk tidak valid diteruskan ke fungsi ini.
Nilai lain	Komponen lain menyebabkan kegagalan. Kegagalan ini dilacak oleh sistem.

Keterangan

Jika APO dapat menerima format yang diminta, APO harus menambahkan referensi ke format yang diminta, mengembalikan ini sebagai format output yang didukung, dan mengembalikan S_OK.

Jika APO tidak dapat menerima format yang diminta, APO dapat menyarankan format alternatif yang diminta. Dalam hal ini harus membuat dan mengembalikan format yang disarankan, dan mengembalikan S_FALSE.

Format yang didukung yang dikembalikan harus 'paling dekat' dengan format yang diminta, yang berarti bahwa format harus memiliki nilai yang sama untuk properti berikut, yang ditentukan dalam urutan prioritas.

• format sampel
• kedalaman bit
• jumlah saluran
• laju sampel

Format yang disarankan mungkin hanya berbeda dari format yang diminta jika S_FALSE dikembalikan. Saat mengembalikan kegagalan apa pun, format yang disarankan harus dibiarkan tidak tersentuh.

API ini dapat dipanggil kapan saja. Hasil yang dikembalikan akan tergantung pada status internal APO yang dapat dimanipulasi oleh antarmuka pengguna eksternal. Setelah APO dikunci untuk diproses, namun, format ini tidak dapat dan tidak akan berubah.

Metode ini mungkin tidak dipanggil dari utas pemrosesan real time.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 Build 20348
Header	audioenginebaseapo.h