structure KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

Article
03/01/2024

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

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ée en unités de 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 des octets. 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 de paquet maximale absolue 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 être au moins 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 égale à 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Tableau de contraintes de mode de traitement 0 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
En-tête	ksmedia.h

Partager via