struttura KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

Articolo
02/07/2025

La struttura KSAUDIO_PACKETSIZE_CONSTRAINTS2 descrive i vincoli hardware fisici. Include una matrice di 0 o più strutture KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT che descrivono vincoli specifici di qualsiasi modalità di elaborazione dei segnali. Il driver imposta questa proprietà prima di chiamare PcRegisterSubdevice o abilitare in altro modo l'interfaccia del filtro KS per i relativi pin di streaming.

Sintassi

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

Membri

MinPacketPeriodInHns

Periodo di elaborazione minimo assoluto supportato dal driver espresso in unità HNS (hundred-nanosecond). Questo valore può essere 0 se il driver non ha un periodo di elaborazione minimo specifico.

PacketSizeFileAlignment

Requisito di allineamento delle dimensioni dei byte. Usare uno di questi valori di allineamento dei file definiti:

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

Dimensione massima assoluta dei pacchetti supportata dal driver in byte. Può essere zero se il driver non ha dimensioni massime massime specifiche. Questa dimensione deve essere almeno sufficientemente grande per supportare il buffer di 10 ms di qualsiasi formato supportato dal pin. Questa dimensione deve essere anche maggiore o uguale ai vincoli MinPacketSize.

NumProcessingModeConstraints

Numero di vincoli aggiuntivi per modalità di elaborazione specifiche. Questo valore può essere 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Matrice di 0 o più vincoli di modalità di elaborazione.

Osservazioni

Il driver imposta questa struttura di dati a lunghezza variabile come valore della proprietà DEVPKEY_KsAudio_PacketSize_Constraints2 sull'interfaccia PnP del filtro KS con i pin di streaming con i vincoli.

Per i driver WaveRT, questa struttura di dati descrive i vincoli per un pacchetto WaveRT. Diversi pacchetti WaveRT (in genere 2) vengono concatenati per formare il buffer WaveRT.

Lo struct KSAUDIO_PACKETSIZE_CONSTRAINTS2 è disponibile a partire da Windows 10 versione 1607.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
intestazione	ksmedia.h

Condividi tramite