IAMDecoderCaps ::GetDecoderCaps, 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 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 GetDecoderCaps méthode interroge le décodeur pour ses fonctionnalités.
Syntaxe
HRESULT GetDecoderCaps(
[in] DWORD dwCapIndex,
[out] DWORD *lpdwCap
);
Paramètres
[in] dwCapIndex
Spécifie la fonctionnalité pour laquelle vous interrogez.
| Constant | Valeur | Description |
|---|---|---|
| AM_QUERY_DECODER_VMR_SUPPORT | 0x00000001 | Prise en charge du filtre de rendu de mixage vidéo 7 (VMR-7) |
| AM_QUERY_DECODER_DXVA_1_SUPPORT | 0x00000002 | Prise en charge de l’accélération vidéo DirectX |
| AM_QUERY_DECODER_DVD_SUPPORT | 0x00000003 | Prise en charge de la vidéo DVD |
| AM_QUERY_DECODER_ATSC_SD_SUPPORT | 0x00000004 | Prise en charge de la vidéo ATSC en définition standard (SD) |
| AM_QUERY_DECODER_ATSC_HD_SUPPORT | 0x00000005 | Prise en charge de la vidéo HAUTE définition (HD) ATSC |
| AM_GETDECODERCAP_QUERY_VMR9_SUPPORT | 0x00000006 | Prise en charge du filtre de rendu de mixage vidéo 9 (VMR-9) |
| AM_GETDECODERCAP_QUERY_EVR_SUPPORT | 0x00000007 | Prise en charge améliorée du convertisseur vidéo (EVR). |
[out] lpdwCap
Reçoit l’une des valeurs suivantes.
| Valeur | Description |
|---|---|
| DECODER_CAP_NOTSUPPORTED | Le décodeur ne prend pas en charge cette fonctionnalité. |
| DECODER_CAP_SUPPORTED | Le décodeur prend en charge cette fonctionnalité. |
Valeur retournée
Si la méthode réussit, retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
Le Générateur de graphiques DVD utilise cette méthode lorsqu’il génère un graphique DVD. Si le décodeur ne prend pas en charge le filtre Convertisseur de mixage vidéo, le Générateur de graphiques DVD utilise le filtre Overlay Mixer à la place.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |