IVMRMonitorConfig::SetDefaultMonitor, 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 SetDefaultMonitor méthode spécifie le moniteur par défaut que toutes les instances futures du VMR doivent utiliser pour la lecture vidéo.
Syntaxe
HRESULT SetDefaultMonitor(
[in] const VMRGUID *pGUID
);
Paramètres
[in] pGUID
Pointeur vers une structure VMRGUID qui identifie le moniteur.
Valeur renvoyée
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Impossible de définir le moniteur spécifié comme par défaut. |
|
Argument non valide. Le moniteur spécifié n’existe pas ou le paramètre pGUID n’a pas été mis en forme correctement. |
|
Argument pointeur NULL . |
|
Opération réussie. |
|
L’allocator-presenter n’a pas été chargé. |
Notes
Utilisez cette méthode sur un système multi-moniteurs pour spécifier au VMR l’appareil DirectDraw par défaut à utiliser lors de la connexion à un filtre amont. L’appareil DirectDraw par défaut peut être remplacé pour une connexion particulière par la méthode SetMonitor .
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
| 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 |