IWMCodecProps::GetCodecProp-Methode (wmcodecdsp.h)

  • Artikel

Ruft eine Codeceigenschaft ab, die für ein Ausgabeformat spezifisch ist.

Syntax

HRESULT GetCodecProp(
  [in]      DWORD             dwFormat,
  [in]      LPCWSTR           pszName,
  [out]     WMT_PROP_DATATYPE *pType,
  [out]     BYTE              *pValue,
  [in, out] DWORD             *pdwSize
);

Parameter

[in] dwFormat

Das Ausgabeformat, auf das die Eigenschaft angewendet wird. Legen Sie diesen Wert auf den FOURCC-Wert des gewünschten Videoformats fest.

[in] pszName

Breitzeichen-, NULL-terminierte Zeichenfolge, die den Eigenschaftsnamen enthält. Die in der folgenden Tabelle aufgeführten Eigenschaften werden nur über die IWMCodecProps-Schnittstelle unterstützt.

Eigenschaftsnamekonstante Bedeutung
g_wszWMCPCodecName
 Ruft den Namen des Codecs ab, der dem Format (oder FOURCC) zugeordnet ist. Dies ist eine Alternative zur IWMCodecStrings-Schnittstelle .
g_wszWMCPSupportedVBRModes
 Ruft die vom Codec unterstützten Codierungsmodi ab. Der zurückgegebene Wert enthält mindestens eins der folgenden Flags:
  • WM_CODEC_ONEPASS_CBR
  • WM_CODEC_ONEPASS_VBR
  • WM_CODEC_TWOPASS_CBR
  • WM_CODEC_TWOPASS_VBR_UNCONSTRAINED
  • WM_CODEC_TWOPASS_VBR_PEAKCONSTRAINED

[out] pType

Adresse einer Variablen, die den Datentyp des Eigenschaftswerts empfängt.

[out] pValue

Adresse des Bytepuffers, der den Eigenschaftswert empfängt.

[in, out] pdwSize

Zeiger auf die Größe des Wertpuffers in Bytes. Wenn pValue NULL ist, legt die Methode diesen Wert auf die erforderliche Größe 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.

Anforderungen

   
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

IWMCodecProps-Schnittstelle