IMFASFStreamConfig::GetPayloadExtension-Methode (wmcontainer.h)

Artikel
08/28/2023

Ruft Informationen zu einer vorhandenen Nutzlasterweiterung ab.

Syntax

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

Parameter

[in] wPayloadExtensionNumber

Der Nutzlasterweiterungsindex. Gültige Indizes reichen von 0 bis 1 kleiner als die Anzahl der Erweiterungen, die durch Aufrufen von IMFASFStreamConfig::GetPayloadExtensionCount abgerufen werden.

[out] pguidExtensionSystemID

Empfängt eine GUID, die die Nutzlasterweiterung identifiziert. Eine Liste der vordefinierten Nutzlasterweiterungen finden Sie unter ASF-Nutzlasterweiterungs-GUIDs. Anwendungen können auch benutzerdefinierte Nutzlasterweiterungen definieren.

[out] pcbExtensionDataSize

Empfängt die Anzahl der Bytes, die jedem Beispiel für die Erweiterung hinzugefügt wurden.

[out] pbExtensionSystemInfo

Zeiger auf einen Puffer, der Informationen zu diesem Erweiterungssystem empfängt. Diese Informationen sind für alle Beispiele identisch und werden im Inhaltsheader (nicht in jedem Beispiel) gespeichert. Dieser Parameter kann NULL sein. Um die erforderliche Größe des Puffers zu ermitteln, legen Sie diesen Parameter auf NULL fest. die Größe wird in pcbExtensionSystemInfo zurückgegeben.

[in, out] pcbExtensionSystemInfo

Gibt bei der Eingabe die Größe des Puffers an, auf den pbExtensionSystemInfo verweist. Empfängt bei der Ausgabe die erforderliche Größe des PbExtensionSystemInfo-Puffers in Bytes.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Ungültiges Argument.
MF_E_BUFFERTOOSMALL	Der in pbExtensionSystemInfo angegebene Puffer ist zu klein.
MF_E_INVALIDINDEX	Der wPayloadExtensionNumber-Parameter liegt außerhalb des Bereichs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcontainer.h
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount

Freigeben über