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.]

Notes

[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]

 

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.

Remarque

Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.

 

Remarque

Pour obtenir Qedit.h, téléchargez Microsoft Windows SDK Update pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.

 

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

Condition requise	Valeur
En-tête	Qedit.h
Bibliothèque	Strmiids.lib

Voir aussi

IPropertySetter, interface

Codes d’erreur et de réussite