IMiniportAudioSignalProcessing ::GetModes, méthode (portcls.h)

Article
02/07/2025

La méthode GetModes récupère les modes de traitement du signal audio pris en charge par une broche audio.

Syntaxe

NTSTATUS GetModes(
  [in]            ULONG Pin,
  [out, optional] GUID  *SignalProcessingModes,
  [in, out]       ULONG *NumSignalProcessingModes
);

Paramètres

[in] Pin

Index de la broche audio.

[out, optional] SignalProcessingModes

Ce paramètre est facultatif. Elle retourne un tableau de GUID qui identifient les modes de traitement des signaux pris en charge par le paramètre Épingler.

[in, out] NumSignalProcessingModes

Lorsqu’il est utilisé comme entrée, il spécifie le nombre d’éléments qui peuvent être écrits dans la mémoire tampon spécifiée dans SignalProcessingModes. Lorsqu’elle est utilisée comme sortie, elle retourne le nombre d’éléments écrits dans la mémoire tampon.

Valeur de retour

GetModes retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Si SignalProcessingModes a la valeur NULL, GetModes écrit le nombre de modes pris en charge dans NumSignalProcessingModes et retourne STATUS_SUCCESS. Cela permet aux appelants d’interroger le nombre de modes pris en charge afin d’allouer des mémoires tampons.

Si SignalProcessingModes n’est pas NULL, GetModes vérifie que NumSignalProcessingModes est supérieur ou égal au nombre de modes pris en charge. Si c’est le cas, la méthode écrit les modes pris en charge dans la mémoire tampon SignalProcessingModes, écrit le nombre réel de modes pris en charge dans NumSignalProcessingModeset retourne STATUS_SUCCESS.

Le tableau suivant présente et explique les messages d’erreur que vous pouvez renvoyer par GetModes.

Code d’erreur	Description
STATUS_BUFFER_TOO_SMALL	La mémoire tampon qui a été mise de côté pour NumSignalProcessingModes est trop petite.
STATUS_INVALID_PARAMETER	La valeur du paramètre Épingler indique un ID d’épingle qui est >= le nombre de fabriques de broches sur le filtre. L’index de broche est de base zéro. Par conséquent, pour n fabriques de broches sur un filtre, la valeur d’index la plus élevée doit être n-1.
STATUS_NOT_SUPPORTED	Un ID de broche a été spécifié pour une broche qui ne prend pas en charge les modes de traitement des signaux. Par exemple, si l’ID de code pin fait référence à une broche de bouclage audio ou à une broche de pont, GetModes retourne ce code d’erreur.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1
serveur minimum pris en charge	Windows Server 2012 R2
plateforme cible	Universel
d’en-tête	portcls.h

Voir aussi

IMiniportAudioSignalProcessing

Partager via