Checks if a particular sample format is supported by a device (endpoint) in exclusive mode.
Namespace: Un4seen.BassWasapi
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax
public static BASSWASAPIFormat BASS_WASAPI_CheckFormat( int device, int freq, int chans, BASSWASAPIFormat format )
Parameters
- device
- Type: SystemInt32
The device to use... 0 = first device, -1 = default device, -2 = default input device. BASS_WASAPI_GetDeviceInfo(Int32, BASS_WASAPI_DEVICEINFO) can be used to enumerate the available devices. - freq
- Type: SystemInt32
The sample rate to check. - chans
- Type: SystemInt32
The number of channels to check... 1 = mono, 2 = stereo, etc. - format
- Type: Un4seen.BassWasapiBASSWASAPIFormat
Limit the sample format that is used in exclusive mode. The default is to try 32-bit floating-point, 32-bit integer, 24-bit integer, 16-bit integer, 8-bit integer, in that order. A BASS_WASAPI_FORMAT value (see BASS_WASAPI_INFO) can be used to bypass the formats that precede it in that list.
Return Value
Type: BASSWASAPIFormatIf the sample format is supported, the maximum supported resolution (a BASSWASAPIFormat value) is returned, else -1 is returned. Use BASS_ErrorGetCode to get the error code.
Remarks
This overload always uses the BASS_WASAPI_EXCLUSIVE flag which will be applied automatically! The format parameter can be used to limit the sample format that is used in exclusive mode.
Call this method prior to BASS_WASAPI_Init(Int32, Int32, Int32, BASSWASAPIInit, Single, Single, WASAPIPROC, IntPtr) in order to make sure the requested format is supported by the Wasapi output device/driver (endpoint).
Shared and exclusive modes may have different sample formats available. Only the "mix format" (available from BASS_WASAPI_GetDeviceInfo(Int32, BASS_WASAPI_DEVICEINFO)) is generally supported in shared mode.
ERROR CODE | Description |
---|---|
BASS_ERROR_WASAPI | WASAPI is not available. |
BASS_ERROR_DEVICE | The device number specified is invalid. |
BASS_ERROR_DRIVER | The driver could not be initialized. |
BASS_ERROR_FORMAT | Unsupported sample format or number of channels. |
See Also