ITAllocatorProperties ::SetAllocatorProperties, méthode (tapi3.h)

La méthode SetAllocatorProperties doit être appelée avant la connexion et force le MSP à utiliser ces valeurs lors de la négociation de filtre. Si le filtre de connexion n’accepte pas ces valeurs, la connexion n’est pas établie.

Syntaxe

HRESULT SetAllocatorProperties(
  [in] ALLOCATOR_PROPERTIES *pAllocProperties
);

Paramètres

[in] pAllocProperties

Pointeur vers la mémoire tampon de l’allocateur.

Valeur retournée

Si la méthode réussit, retourne S_OK. Sinon, elle retourne une valeur d’erreur.

Remarques

Cette méthode doit être utilisée avec la plus grande précaution. La qualité du son peut en souffrir si les valeurs entrées pour cette méthode ne sont pas optimales pour le MSP. Par conséquent, l’application doit connaître exactement les propriétés préférées par le MSP avant d’appeler cette méthode. Sous Windows 2000, les propriétés entrées pendant les appels à cette méthode sont ignorées si elles ne sont pas optimales. Sous Windows XP, ces valeurs ne sont pas ignorées et l’application doit être plus informée.

Si l’application se soucie uniquement de définir des tailles de mémoire tampon cohérentes, la méthode ITAllocatorProperties ::SetBufferSize doit être utilisée à la place. Cela garantit que l’application est fournie avec la taille de mémoire tampon spécifiée.

Configuration requise

Voir aussi

ITAllocatorProperties