Share via

Método IMiniportAudioSignalProcessing::GetModes (portcls.h)

  • Artículo

El método GetModes recupera los modos de procesamiento de señal de audio admitidos por un pin de audio.

Sintaxis

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

Parámetros

[in] Pin

Índice del pin de audio.

[out, optional] SignalProcessingModes

Este parámetro es opcional. Devuelve una matriz de GUID que identifican los modos de procesamiento de señal admitidos por el parámetro Pin .

[in, out] NumSignalProcessingModes

Cuando se usa como entrada, especifica el número de elementos que se pueden escribir en el búfer especificado en SignalProcessingModes. Cuando se usa como salida, devuelve el número de elementos escritos en el búfer.

Valor devuelto

GetModes devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Comentarios

Si SignalProcessingModes es NULL, GetModes escribe el número de modos admitidos en NumSignalProcessingModes y devuelve STATUS_SUCCESS. Esto permite a los autores de llamadas consultar el número de modos admitidos para asignar búferes.

Si SignalProcessingModes no es NULL, GetModes comprueba que NumSignalProcessingModes sea mayor o igual que el número de modos admitidos. Si es así, el método escribe los modos admitidos en el búfer SignalProcessingModes , escribe el número real de modos admitidos en NumSignalProcessingModes y devuelve STATUS_SUCCESS.

En la tabla siguiente se presentan y se explican los mensajes de error que puede devolver GetModes.

Código de error Descripción
STATUS_BUFFER_TOO_SMALL El búfer que se ha reservado para NumSignalProcessingModes es demasiado pequeño.
STATUS_INVALID_PARAMETER El valor del parámetro Pin indica un identificador de pin que es >= el número de generadores de patillas en el filtro. El índice de patillas es de base cero, por lo que para n generadores de patillas en un filtro, el valor de índice más alto debe ser n-1.
STATUS_NOT_SUPPORTED Se especificó un identificador de patilla para un pin que no admite modos de procesamiento de señales. Por ejemplo, si el identificador de pin hace referencia a un pin de bucle invertido de audio o a un pin de puente, GetModes devolverá este código de error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1
Servidor mínimo compatible Windows Server 2012 R2
Plataforma de destino Universal
Encabezado portcls.h

Consulte también

IMiniportAudioSignalProcessing