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

Voir aussi

Codes d’erreur et de réussite

IVMRSurfaceAllocatorNotify, interface

Utilisation du convertisseur de mixage vidéo