IAMStreamConfig ::GetFormat, méthode (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 GetFormat méthode récupère le format de sortie actuel ou préféré.

Syntaxe

HRESULT GetFormat(
  [out] AM_MEDIA_TYPE **ppmt
);

Paramètres

[out] ppmt

Adresse d’un pointeur vers une structure AM_MEDIA_TYPE .

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Remarques

Si la broche est connectée, cette méthode retourne le format utilisé actuellement par la broche. Sinon, la méthode retourne le format préféré de la broche pour la connexion de broche suivante. Si vous avez déjà appelé la méthode IAMStreamConfig ::SetFormat pour définir le format, GetFormat retourne le même format. Si ce n’est pas le cas, il retourne le premier format de la liste des formats préférés de l’épingle, tel que déterminé par la méthode IPin ::EnumMediaTypes .

La méthode alloue la mémoire pour la structure AM_MEDIA_TYPE , remplit la structure et la retourne dans le paramètre pmt . L’appelant doit libérer la mémoire, y compris le bloc de format. Vous pouvez utiliser la fonction d’assistance DeleteMediaType dans la bibliothèque de classes de base.

Sur certains filtres de compression, la méthode échoue si la broche d’entrée du filtre n’est pas connectée.

Exemples

IAMStreamConfig *pConfig = NULL;
// Query the output pin for IAMStreamConfig (not shown).
AM_MEDIA_TYPE *pmt = NULL;
hr = pConfig->GetFormat(&pmt);
if (SUCCEEDED(hr))
{
    /* Examine the media type for any information you need. */
    DeleteMediaType(pmt);
}
pConfig->Release();

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IAMStreamConfig Interface