Método IMiniportAudioSignalProcessing::GetModes (portcls.h)
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 |