Edit

IKsFormatSupport::IsFormatSupported method (devicetopology.h)

  • Article

The IsFormatSupported method indicates whether the audio endpoint device supports the specified audio stream format.

Syntax

HRESULT IsFormatSupported(
  [in]  PKSDATAFORMAT pKsFormat,
  [in]  DWORD         cbFormat,
  [out] BOOL          *pbSupported
);

Parameters

[in] pKsFormat

Pointer to an audio-stream format specifier. This parameter points to a caller-allocated buffer that contains a format specifier. The specifier begins with a KSDATAFORMAT structure that might be followed by additional format information. For more information about KSDATAFORMAT and format specifiers, see the Windows DDK documentation.

[in] cbFormat

The size in bytes of the buffer that contains the format specifier.

[out] pbSupported

Pointer to a BOOL variable into which the method writes a value to indicate whether the format is supported. The method writes TRUE if the device supports the format and FALSE if the device does not support the format.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
E_POINTER
 Pointer pKsFormat or pbSupported is NULL.
E_INVALIDARG
 The format specifier is not valid.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header devicetopology.h

See also

IKsFormatSupport Interface