Edit

Share via

IMFASFMultiplexer::ProcessSample method (wmcontainer.h)

  • Article

Delivers input samples to the multiplexer.

Syntax

HRESULT ProcessSample(
  [in] WORD      wStreamNumber,
  [in] IMFSample *pISample,
  [in] LONGLONG  hnsTimestampAdjust
);

Parameters

[in] wStreamNumber

The stream number of the stream to which the sample belongs.

[in] pISample

Pointer to the IMFSample interface of the input sample. The input sample contains the media data to be converted to ASF data packets. When possible, the time stamp of this sample should be accurate.

[in] hnsTimestampAdjust

The adjustment to apply to the time stamp of the sample. This parameter is used if the caller wants to shift the sample time on pISample. This value should be positive if the time stamp should be pushed ahead and negative if the time stamp should be pushed back. This time stamp is added to sample time on pISample, and the resulting time is used by the multiplexer instead of the original sample time. If no adjustment is needed, set this value to 0.

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.
MF_E_NOTACCEPTING
 There are too many packets waiting to be retrieved from the multiplexer. Call IMFASFMultiplexer::GetNextPacket to get the packets.
MF_E_BANDWIDTH_OVERRUN
 The sample that was processed violates the bandwidth limitations specified for the stream in the ASF ContentInfo object. When this error is generated, the sample is dropped.
MF_E_INVALIDSTREAMNUMBER
 The value passed in wStreamNumber is invalid.
MF_E_LATE_SAMPLE
 The presentation time of the input media sample is earlier than the send time.

Remarks

The application passes samples to ProcessSample, and the ASF multiplexer queues them internally until they are ready to be placed into ASF packets. Call IMFASFMultiplexer::GetNextPacket to get the ASF data packet.

After each call to ProcessSample, call GetNextPacket in a loop to get all of the available data packets. For a code example, see Generating New ASF Data Packets.

Requirements

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

See also

Generating New ASF Data Packets

IMFASFMultiplexer

IMFSample