IWMWriterAdvanced::GetSinkCount method (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The GetSinkCount method retrieves the number of writer sinks associated with the writer object. To obtain a pointer to an interface of an individual sink, call IWMWriterAdvanced::GetSink using a sink number between 0 and one less than the count returned by this method.

Syntax

HRESULT GetSinkCount(
  [out] DWORD *pcSinks
);

Parameters

[out] pcSinks

DWORD indicating the total number of sinks associated with the writer object.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_INVALIDARG
pcSinks is NULL.

Remarks

If you specify a file by calling IWMWriter::SetOutputFilename, the writer object will automatically create a file sink and add it to the writer. That sink will be included in the count retrieved by this method.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wmsdkidl.h (include Wmsdk.h)
Library Wmvcore.lib; WMStubDRM.lib (if you use DRM)

See also

Enumerating Sinks

IWMWriterAdvanced Interface

IWMWriterAdvanced::GetSink