функция обратного вызова EVT_AUDIO_SENSORS_BUFFER (audiosensors.h)

Функция обратного вызова EVT_AUDIO_SENSORS_BUFFER используется для буферных операций между драйверами аудио и драйверами звуковых датчиков. Этот обратный вызов использует несколько вариантов использования, включая получение буферов, параметры буферов и отправку отчетов чтения.

Синтаксис

EVT_AUDIO_SENSORS_BUFFER EvtAudioSensorsBuffer;

NTSTATUS EvtAudioSensorsBuffer(
  PVOID Context,
  AUDIO_MODULE_ID ModuleId,
  ULONG SensorsSessionId,
  PULONG BufferSize,
  PVOID Buffer
)
{...}

Параметры

Context

Указатель на контекст драйвера звуковых датчиков.

ModuleId

Структура AUDIO_MODULE_ID , идентифицирующая целевой звуковой модуль.

SensorsSessionId

Идентификатор сеанса, возвращаемый обратным вызовом EVT_AUDIO_SENSORS_START_SESSION . Значение 0 указывает запрос, который не связан с определенным сеансом звуковых датчиков.

BufferSize

Указатель на ULONG, содержащий размер буфера в байтах. При входных данных это указывает размер предоставленного буфера. В выходных данных это можно обновить, чтобы указать фактический размер буфера, используемый или необходимый.

Buffer

Необязательный указатель на закрытый буфер, используемый для обмена данными. Размер буфера указывается параметром BufferSize .

Возвращаемое значение

Возвращает значение NTSTATUS. Возвращает STATUS_SUCCESS , если операция выполнена успешно. В противном случае верните соответствующий код ошибки NTSTATUS.

Замечания

Тип функции обратного вызова EVT_AUDIO_SENSORS_BUFFER используется для трех различных операций буфера в интерфейсе звуковых датчиков:

• EvtAudioSensorsGetBuffer — используется для извлечения данных буфера из драйвера звуковых датчиков
• EvtAudioSensorsSetBuffer — используется для задания буферных данных в драйвере датчиков звука
• EvtAudioSensorsSubmitReadReport — используется звуковым драйвером для отправки отчетов для чтения в драйвер датчиков

Конкретная операция зависит от того, какой указатель функции используется в структуре AUDIO_SENSORS_INTERFACE_V0100 .

Параметр SensorSessionId связывает операции с определенным сеансом датчика, созданным EVT_AUDIO_SENSORS_START_SESSION. Если значение равно 0, операция не связана с определенным сеансом.

Требования

См. также

• AUDIO_SENSORS_INTERFACE_V0100
• AUDIO_MODULE_ID
• EVT_AUDIO_SENSORS_START_SESSION
• EVT_AUDIO_SENSORS_STOP_SESSION