IWMCodecProps::GetCodecProp, méthode (wmcodecdsp.h)

Récupère une propriété de codec spécifique à un format de sortie.

Syntaxe

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

Paramètres

[in] dwFormat

Format de sortie auquel la propriété s’applique. Définissez cette valeur sur la valeur FOURCC du format vidéo souhaité.

[in] pszName

Chaîne à caractères larges, terminée par null, contenant le nom de propriété. Les propriétés répertoriées dans le tableau suivant sont prises en charge uniquement via l’interface IWMCodecProps.

Constante de nom de propriété Signification
g_wszWMCPCodecName
Récupère le nom du codec associé au format (ou FOURCC). Il s’agit d’une alternative à l’interface IWMCodecStrings .
g_wszWMCPSupportedVBRModes
Récupère les modes d’encodage pris en charge par le codec. La valeur retournée contient un ou plusieurs des indicateurs suivants :
  • 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 d’une variable qui reçoit le type de données de la valeur de propriété.

[out] pValue

Adresse de la mémoire tampon d’octets qui reçoit la valeur de la propriété.

[in, out] pdwSize

Pointeur vers la taille de la mémoire tampon de valeur, en octets. Si pValue a la valeur NULL, la méthode définit cette valeur sur la taille requise.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
S_OK

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wmcodecdsp.h

Voir aussi

IWMCodecProps, interface