Windows Media Format SDK banner art
PreviousNext

IWMReaderAdvanced::SetReceiveStreamSamples

The SetReceiveStreamSamples method specifies whether stream samples are delivered to the IWMReaderCallbackAdvanced::OnStreamSample call. Stream samples are samples directly from the source file, and are not decompressed

Syntax

HRESULT SetReceiveStreamSamples(
  WORD  wStreamNum,
  BOOL  fReceiveStreamSamples
);

Parameters

  wStreamNum

[in]  Word containing the stream number.

  fReceiveStreamSamples

[in]  Flag indicating that stream samples can be received.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Meaning
E_UNEXPECTED The method failed for an unspecified reason.
E_NOINTERFACE No callback interface has been specified.

Remarks

The user can register himself to receive samples directly from the Windows Media streams rather than letting the reader decompress them. To do this, the IWMReaderCallback (supplied by the user) must support IWMReaderCallbackAdvanced. To get actual information about the contents of a stream, call QueryInterface on the stream configuration object to retrieve the IWMProfile interface.

Stream numbers may only be in the range of 1-64.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.