IAMBufferNegotiation ::SuggestAllocatorProperties, 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 SuggestAllocatorProperties méthode informe l’épingle des propriétés d’allocateur préférées de l’application. Appelez cette méthode avant la connexion de l’épingle.

Syntaxe

HRESULT SuggestAllocatorProperties(
  [in] const ALLOCATOR_PROPERTIES *pprop
);

Paramètres

[in] pprop

Pointeur vers une structure ALLOCATOR_PROPERTIES qui contient les propriétés demandées. Une valeur négative pour tout membre indique que l’épingle doit utiliser son paramètre par défaut pour cette propriété.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Remarques

Si les deux broches de la connexion exposent l’interface IAMBufferNegotiation , appelez cette méthode sur chaque broche pour vous assurer qu’une broche ne remplace pas l’autre.

Pour demander un nombre particulier de mémoires tampons, définissez le membre cBuffers de la structure ALLOCATOR_PROPERTIES . Pour demander une taille de mémoire tampon particulière, définissez le membre cbBuffer . Une application ne doit généralement pas spécifier l’alignement ou le préfixe. Si le nombre de mémoires tampons ou la taille de chaque mémoire tampon est trop faible, le graphique de filtre peut supprimer des échantillons.

Exemples

ALLOCATOR_PROPERTIES AllocProp;
AllocProp.cbAlign = -1;  // -1 means no preference.
AllocProp.cbBuffer = dwBytesPerSec *  dwLatencyInMilliseconds / 1000;
AllocProp.cbPrefix = -1;
AllocProp.cBuffers = -1;
pIAMBufferNegotiation->SuggestAllocatorProperties(&AllocProp);

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IAMBufferNegotiation, interface