IMFMediaSink::GetCharacteristics method (mfidl.h)
Gets the characteristics of the media sink.
Syntax
HRESULT GetCharacteristics(
[out] DWORD *pdwCharacteristics
);
Parameters
[out] pdwCharacteristics
Receives a bitwise OR of zero or more flags. The following flags are defined:
| Value | Meaning |
|---|---|
|
The media sink has a fixed number of streams. It does not support the IMFMediaSink::AddStreamSink and IMFMediaSink::RemoveStreamSink methods. This flag is a hint to the application. |
|
The media sink cannot match rates with an external clock.
For best results, this media sink should be used as the time source for the presentation clock. If any other time source is used, the media sink cannot match rates with the clock, with poor results (for example, glitching). This flag should be used sparingly, because it limits how the pipeline can be configured. For more information about the presentation clock, see Presentation Clock. |
|
The media sink is rateless. It consumes samples as quickly as possible, and does not synchronize itself to a presentation clock.
Most archiving sinks are rateless. |
|
The media sink requires a presentation clock. The presentation clock is set by calling the media sink's IMFMediaSink::SetPresentationClock method.
This flag is obsolete, because all media sinks must support the SetPresentationClock method, even if the media sink ignores the clock (as in a rateless media sink). |
|
The media sink can accept preroll samples before the presentation clock starts. The media sink exposes the IMFMediaSinkPreroll interface. |
|
The first stream sink (index 0) is a reference stream. The reference stream must have a media type before the media types can be set on the other stream sinks. |
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The media sink's Shutdown method has been called. |
Remarks
The characteristics of a media sink are fixed throughout the life time of the sink.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | mfidl.h |
| Library | Mfuuid.lib |