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

Статья
02/07/2025

Структура 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

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