IWMCodecPrivateData::GetPrivateData-Methode (wmcodecdsp.h)

Artikel
03/09/2024

Ruft die Codecdaten für den Videoinhalt basierend auf dem Ausgabetyp ab, der mit der IWMCodecPrivateData::SetPartialOutputType-Methode übergeben wird.

Syntax

HRESULT GetPrivateData(
  [out]     BYTE  *pbData,
  [in, out] ULONG *pcbData
);

Parameter

[out] pbData

Adresse des Puffers, der die privaten Daten empfängt. Wenn Sie dies auf NULL festlegen, wird die größe, die zum Aufnehmen der privaten Daten erforderlich ist, in pcbData zurückgegeben.

[in, out] pcbData

Zeiger auf die Größe der privaten Daten in Bytes. Wenn pbData NULL ist, legt die Methode dies auf den richtigen Wert fest.

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.

Hinweise

Wenn Sie Eigenschaften für das Encoderobjekt festlegen, müssen Sie diese Konfiguration abschließen, bevor Sie die privaten Daten abrufen. Durch das Ändern der Eigenschaften werden alle zuvor abgerufenen privaten Daten ungültig. Wenn Sie die Eigenschaften ändern, nachdem Sie die privaten Daten abgerufen haben, rufen Sie sie erneut ab, und setzen Sie den Ausgabetyp zurück.

Sie müssen diese Methode aufrufen, nachdem Sie den Codec mit dem Ausgabemedientyp (ohne angefügte private Daten) bereitgestellt haben, indem Sie IWMCodecPrivateData::SetPartialOutputType aufrufen.

Ordnen Sie nach dem Abrufen der privaten Daten einen Puffer die Größe von VIDEOINFOHEADER plus pcbData zu. Kopieren Sie dann die Daten von Ihrem partiellen Ausgabetyp an den Anfang des Puffers, und fügen Sie die privaten Daten an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcodecdsp.h

Weitere Informationen

IWMCodecPrivateData-Schnittstelle

Share via