структура KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

Статья
08/07/2023

Структура KSAUDIO_PACKETSIZE_CONSTRAINTS2 описывает физические аппаратные ограничения. Он содержит массив из 0 или более KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT структур, описывающих ограничения, характерные для любых режимов обработки сигналов. Драйвер задает это свойство перед вызовом PcRegisterSubdevice или другим способом включения интерфейса фильтра KS для контактов потоковой передачи.

Синтаксис

typedef struct _KSAUDIO_PACKETSIZE_CONSTRAINTS2 {
  ULONG                                        MinPacketPeriodInHns;
  ULONG                                        PacketSizeFileAlignment;
  ULONG                                        MaxPacketSizeInBytes;
  ULONG                                        NumProcessingModeConstraints;
  KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT ProcessingModeConstraints[ANYSIZE_ARRAY];
} KSAUDIO_PACKETSIZE_CONSTRAINTS2;

Члены

MinPacketPeriodInHns

Абсолютный минимальный период обработки, поддерживаемый драйвером, выраженный в единицах HNS. Это значение может быть равно 0, если драйвер не имеет определенного минимального периода обработки.

PacketSizeFileAlignment

Требование выравнивания размера байтов. Используйте одно из указанных ниже значений выравнивания файлов:

FILE_BYTE_ALIGNMENT

FILE_WORD_ALIGNMENT

FILE_LONG_ALIGNMENT

FILE_QUAD_ALIGNMENT

FILE_OCTA_ALIGNMENT

FILE_32_BYTE_ALIGNMENT

FILE_64_BYTE_ALIGNMENT

FILE_128_BYTE_ALIGNMENT

FILE_256_BYTE_ALIGNMENT

FILE_512_BYTE_ALIGNMENT

MaxPacketSizeInBytes

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

NumProcessingModeConstraints

Количество дополнительных ограничений для определенных режимов обработки. Может иметь значение 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Массив из 0 или более ограничений режима обработки.

Драйвер задает эту структуру данных переменной длины как значение свойства DEVPKEY_KsAudio_PacketSize_Constraints2 в интерфейсе PnP фильтра KS, имеющего контакты потоковой передачи с ограничениями.

Для драйверов WaveRT эта структура данных описывает ограничения для пакета WaveRT. Несколько пакетов WaveRT (обычно 2) объединяются для формирования буфера WaveRT.

Структуру KSAUDIO_PACKETSIZE_CONSTRAINTS2 можно использовать начиная с Windows 10 версии 1607.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Верхняя часть	ksmedia.h

Поделиться через