IMFASFStreamConfig::GetPayloadExtension-Methode (wmcontainer.h)

  • Artikel

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