IltmfAudioFormats::Find

Summary

Retrieves the index of the audio format that matches the specified criteria (frequency, bits per sample and number of channels).

Syntax

#include "ltmf.h"

Language Syntax
C HRESULT IltmfAudioFormats_Find(pAudioFormats, Freq, Bits, Channels, Index)
C++ HRESULT Find(pAudioFormats, Freq, Bits, Channels, Index)

Parameters

IltmfAudioFormats *pAudioFormats

Pointer to an IltmfAudioFormats Interface.

long Freq

Value that represents the frequency, in Hertz, of the audio format to be found. Common values include: 8000, 11025, 16000, 22050, 32000, and 44100 Hz..

long Bits

Value the represents the number of bits per sample of the audio format to be found. Common values include 8- and 16-bits per sample.

long Channels

Value that represents the number of channels of the audio format to be found. Common values include 1 (mono) and 2 (stereo).

long *Index

Pointer to a variable that receives the zero-based index of the audio format matching the specified criteria. A value of 1 indicates that no match was found.

Returns

Value Meaning
S_OK The function was successful.
<> S_OK An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation documentation.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For a C++ example, refer to IltmfAudioFormats::get_Count Example for C++.

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Media Foundation C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.