structure KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

Article
02/07/2025

La structure KSAUDIO_PACKETSIZE_CONSTRAINTS2 décrit les contraintes matérielles physiques. Il inclut un tableau de 0 ou plus KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT structures décrivant des contraintes spécifiques à tous les modes de traitement de signal. Le pilote définit cette propriété avant d’appeler PcRegisterSubdevice ou d’activer son interface de filtre KS pour ses broches de diffusion en continu.

Syntaxe

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

Membres

MinPacketPeriodInHns

Période de traitement minimale absolue prise en charge par le pilote exprimé en cent nanosecondes (HNS). Cette valeur peut être 0 si le pilote n’a pas de période de traitement minimale spécifique.

PacketSizeFileAlignment

Exigence d’alignement de la taille d’octet. Utilisez l’une de ces valeurs d’alignement de fichiers définies :

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

Taille maximale absolue du paquet prise en charge par le pilote en octets. Cela peut être égal à zéro si le pilote n’a pas de taille de paquet maximale spécifique. Cette taille doit au moins être suffisamment grande pour prendre en charge la mémoire tampon de 10 ms de n’importe quel format pris en charge par la broche. Cette taille doit également être supérieure ou égale aux contraintes MinPacketSize.

NumProcessingModeConstraints

Nombre de contraintes supplémentaires pour des modes de traitement spécifiques. Cette valeur peut être 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Tableau de 0 contraintes de mode de traitement ou plus.

Remarques

Le pilote définit cette structure de données de longueur variable comme valeur de la propriété DEVPKEY_KsAudio_PacketSize_Constraints2 sur l’interface PnP du filtre KS qui a les broches de diffusion en continu avec les contraintes.

Pour les pilotes WaveRT, cette structure de données décrit les contraintes d’un paquet WaveRT. Plusieurs paquets WaveRT (généralement 2) sont concaténés pour former la mémoire tampon WaveRT.

Le struct KSAUDIO_PACKETSIZE_CONSTRAINTS2 est disponible à partir de Windows 10, version 1607.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
d’en-tête	ksmedia.h

Partager via