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

Artigo
02/07/2025

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

Consulte também

IMiniportAudioSignalProcessing

Compartilhar via