struttura KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

Articolo
08/07/2023

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 per qualsiasi modalità di elaborazione del segnale. Il driver imposta questa proprietà prima di chiamare PcRegisterSubdevice o abilitare in altro modo l'interfaccia del filtro KS per i 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;

Members

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 dei valori di allineamento dei file definiti seguenti:

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 specifiche del pacchetto. Questa dimensione deve essere almeno sufficientemente grande per supportare il buffer di 10 ms di qualsiasi formato supportato dal pin. Questa dimensione deve anche essere 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.

Commenti

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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Intestazione	ksmedia.h

Condividi tramite