Метод IMiniportAudioSignalProcessing::GetModes (portcls.h)
Метод GetModes извлекает режимы обработки звуковых сигналов, поддерживаемые аудиокреплением.
Синтаксис
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
Параметры
[in] Pin
Индекс аудиокрепли.
[out, optional] SignalProcessingModes
Этот параметр является необязательным. Он возвращает массив идентификаторов GUID, определяющих режимы обработки сигналов, поддерживаемые параметром пин-кода.
[in, out] NumSignalProcessingModes
При использовании в качестве входных данных он указывает количество элементов, которые можно записать в буфер, указанный в SignalProcessingModes. При использовании в качестве выходных данных возвращается количество элементов, записанных в буфер.
Возвращаемое значение
GetModes возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки.
Замечания
Если SignalProcessingModes имеет значение NULL, GetModes записывает количество поддерживаемых режимов в NumSignalProcessingModes и возвращает STATUS_SUCCESS. Это позволяет вызывающим пользователям запрашивать количество поддерживаемых режимов, чтобы выделить буферы.
Если SignalProcessingModes не имеет значения NULL, GetModes проверяет, что NumSignalProcessingModes больше или равно количеству поддерживаемых режимов. Если это так, метод записывает поддерживаемые режимы в буфер SignalProcessingModes, записывает фактическое количество поддерживаемых режимов в NumSignalProcessingModesи возвращает STATUS_SUCCESS.
В следующей таблице представлены и объясняются сообщения об ошибках, которые могут быть возвращены GetModes.
| Код ошибки | Описание |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Буфер, который был выделен для NumSignalProcessingModes слишком мал. |
| STATUS_INVALID_PARAMETER | Значение параметра пин-кода указывает идентификатор пин-кода, который >= количество фабрик закреплений в фильтре. Индекс пин-кода отсчитывается от нуля, поэтому для n-заводов в фильтре наибольшее значение индекса должно быть n-1. |
| STATUS_NOT_SUPPORTED | Идентификатор пин-кода был указан для пин-кода, который не поддерживает режимы обработки сигналов. Например, если идентификатор пин-кода ссылается на пин-код аудиозаписи или закрепление моста, то GetModes вернет этот код ошибки. |
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8.1 |
| минимальный поддерживаемый сервер | Windows Server 2012 R2 |
| целевая платформа | Всеобщий |
| заголовка | portcls.h |