IMFASFStreamConfig::AddPayloadExtension method (wmcontainer.h)

Configures a payload extension for the stream.

Syntax

HRESULT AddPayloadExtension(
  [in] GUID  guidExtensionSystemID,
  [in] WORD  cbExtensionDataSize,
  [in] BYTE  *pbExtensionSystemInfo,
  [in] DWORD cbExtensionSystemInfo
);

Parameters

[in] guidExtensionSystemID

Pointer to a GUID that identifies the payload extension. For a list of predefined payload extensions, see ASF Payload Extension GUIDs. Applications can also define custom payload extensions.

[in] cbExtensionDataSize

Number of bytes added to each sample for the extension.

[in] pbExtensionSystemInfo

A pointer to a buffer that contains information about this extension system. This information is the same for all samples and is stored in the content header (not with each sample). This parameter can be NULL if cbExtensionSystemInfo is 0.

[in] cbExtensionSystemInfo

Amount of data, in bytes, that describes this extension system. If this value is 0, then pbExtensionSystemInfo can be NULL.

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.

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

IMFASFStreamConfig

IMFASFStreamConfig::GetPayloadExtension