IPropertySetter::GetProps, méthode

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La GetProps méthode récupère les propriétés définies sur cet objet, avec leurs valeurs correspondantes.

Syntaxe

HRESULT GetProps(
  [out] LONG         *pcParams,
  [out] DEXTER_PARAM **paParam,
  [out] DEXTER_VALUE **paValue
);

Paramètres

pcParams [out]

Reçoit le nombre de structures retournées dans paParam.

paParam [out]

Adresse d’un pointeur vers un tableau de structures DEXTER_PARAM .

paValue [out]

Adresse d’un pointeur vers un tableau de structures DEXTER_VALUE .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Pour chaque propriété retournée dans paParam, le membre nValues indique le nombre de structures DEXTER_VALUE associées à la propriété. Les paires sont retournées dans l’ordre temporel croissant pour chaque propriété.

Lorsque vous avez terminé d’utiliser les structures retournées, appelez IPropertySetter::FreeProps pour libérer les ressources allouées par cette méthode.

Exemples

L’exemple de code suivant montre comment itérer au sein de toutes les valeurs d’un instance de la propriété setter :

IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).

DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;

hr = pSetter->GetProps(&count, &pParam, &pValue);

LONG num = 0;
for (LONG i = 0; i < count; i++)
{
    for (LONG j = 0; j < pParam[i].nValues; j++)
    {
        // pValue[num] is the next value in the sequence for pParam[i]
    }
    num += pParam[i].nValues;
}

Configuration requise

Voir aussi

IPropertySetter, interface

Codes d’erreur et de réussite