Compartilhar via

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

  • Artigo

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 uma 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.

Retornar valor

GetModes retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro apropriado.

Comentários

Se SignalProcessingModes for NULL, GetModes gravará o número de modos com suporte em 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 for, o método gravará os modos com suporte no buffer SignalProcessingModes , gravará o número real de modos com suporte em NumSignalProcessingModes e retornará STATUS_SUCCESS.

A tabela a seguir apresenta e explica as mensagens de erro que podem ser retornadas por GetModes.

Código do 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 >= o número de fábricas de pinos no filtro. O índice de pino é 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 Pino foi especificada para um pin que não dá suporte a modos de processamento de sinal. Por exemplo, se a ID do Pino 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
Cliente mínimo com suporte Windows 8.1
Servidor mínimo com suporte Windows Server 2012 R2
Plataforma de Destino Universal
Cabeçalho portcls.h

Confira também

IMiniportAudioSignalProcessing