IVMRMonitorConfig ::SetMonitor, 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.]
Sur un système à plusieurs moniteurs, la SetMonitor méthode spécifie le moniteur que cette instance du VMR doit utiliser pour la lecture vidéo.
Syntaxe
HRESULT SetMonitor(
[in] const VMRGUID *pGUID
);
Paramètres
[in] pGUID
Pointeur vers une structure VMRGUID qui identifie le moniteur.
Valeur retournée
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Argument non valide. |
|
Argument pointeur NULL . |
|
Réussite. |
|
L’allocator-presenter n’a pas été chargé. |
Remarques
Utilisez cette méthode sur un système multi-moniteur pour spécifier au VMR quel pilote DirectDraw doit être utilisé lors de la connexion à un filtre de décodeur amont.
Le membre pGUID de la structure VMRGUID doit être NULL, indiquant l’appareil DirectDraw par défaut, ou égal à l’adresse du membre GUID de la structure VMRGUID . Sinon, la méthode retourne E_INVALIDARG.
Si le GUID spécifié ne correspond à aucun moniteur, la méthode retourne E_INVALIDARG.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP avec SP1 [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 |