IVMRSurfaceAllocatorNotify ::AdviseSurfaceAllocator, 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 AdviseSurfaceAllocator méthode est appelée par une application pour demander au VMR d’utiliser un présentateur-allocator personnalisé.
Syntaxe
HRESULT AdviseSurfaceAllocator(
[in] DWORD_PTR dwUserID,
[in] IVMRSurfaceAllocator *lpIVRMSurfaceAllocator
);
Paramètres
[in] dwUserID
Une DWORD_PTR définie par l’application qui identifie de manière unique cette instance du VMR dans les scénarios où plusieurs instances du VMR sont utilisées avec une seule instance d’un allocator-présentateur.
[in] lpIVRMSurfaceAllocator
Spécifie l’interface IVMRSurfaceAllocator sur le nouvel allocator-présentateur. Si cette valeur est NULL, le vmR libère l’allocator-présentateur client et restaure son allocator-presenter par défaut.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Remarques
La méthode entraîne la désinstallation et la destruction de l’allocator-présentateur par défaut, puis le remplacement par le nouveau composant spécifié. Le nouveau composant doit également prendre en charge l’interface IVMRImagePresenter .
Cette méthode ne peut être appelée qu’une seule fois dans la durée de vie du VMR. Le VMR continue d’utiliser l’allocator-presenter jusqu’à ce que le VMR soit lui-même supprimé. Lorsque le VMR est enfin publié, il libère son nombre de références sur l’objet d’allocator-présentateur personnalisé, ce qui permet à cet objet d’être libéré.
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 |