Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Callback function that allows APOs to specify a preferred input format for the provided output format.
Syntax
HRESULT GetPreferredInputFormat(
[in] IAudioMediaType *outputFormat,
[out] IAudioMediaType **preferredFormat
);
Parameters
[in] outputFormat
An IAudioMediaType representing the output format associated with the callback.
[out] preferredFormat
An IAudioMediaType representing the preferred input format for the APO.
Return value
An HRESULT.
Remarks
This API enables scenarios such as a headphone provider that provides virtual surround sound. The APO could request to receive 7-1 input even though the endpoint renders in stereo. APOs can specify different preferred formats for different output formats. For example, an app may request 7.1 input when the m stream type is media, but request stereo input when the stream type is communications.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11, version 23H2 |
| Header | audioengineextensionapo.h |