Método IMiniportAudioSignalProcessing::GetModes (portcls.h)
O método GetModes recupera os modos de processamento de sinal de áudio compatíveis com um pino de áudio.
Sintaxe
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
Parâmetros
[in] Pin
O índice do pino de áudio.
[out, optional] SignalProcessingModes
Esse parâmetro é opcional. Ele retorna uma matriz de GUIDs que identificam os modos de processamento de sinal compatíveis com o parâmetro Pin.
[in, out] NumSignalProcessingModes
Quando usado como entrada, ele especifica o número de elementos que podem ser gravados no buffer especificado em SignalProcessingModes. Quando usado como uma saída, ele retorna o número de elementos que foram gravados no buffer.
Valor de retorno
GetModes retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro apropriado.
Observações
Se SignalProcessingModes for NULL, GetModes gravará o número de modos com suporte para NumSignalProcessingModes e retornará STATUS_SUCCESS. Isso permite que os chamadores consultem o número de modos com suporte para alocar buffers.
Se SignalProcessingModes não for NULL, GetModes verificará se NumSignalProcessingModes é maior ou igual ao número de modos com suporte. Se estiver, o método gravará os modos com suporte no buffer SignalProcessingModes, gravará o número real de modos com suporte para NumSignalProcessingModes e retornará STATUS_SUCCESS.
A tabela a seguir apresenta e explica as mensagens de erro que podem ser retornadas por GetModes.
| Código de erro | Descrição |
|---|---|
| STATUS_BUFFER_TOO_SMALL | O buffer que foi reservado para NumSignalProcessingModes é muito pequeno. |
| STATUS_INVALID_PARAMETER | O valor do parâmetro Pin indica uma ID de pino que é >= o número de fábricas de pinos no filtro. O índice de pinos é baseado em zero, portanto, para n fábricas de pinos em um filtro, o valor de índice mais alto deve ser n-1. |
| STATUS_NOT_SUPPORTED | Uma ID de pin foi especificada para um pino que não dá suporte a modos de processamento de sinal. Por exemplo, se a ID do Pin se referir a um pino de loopback de áudio ou a um pino de ponte, GetModes retornará esse código de erro. |
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8.1 |
| servidor com suporte mínimo | Windows Server 2012 R2 |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h |