KSAUDIO_PACKETSIZE_CONSTRAINTS2-Struktur (ksmedia.h)

Artikel
02/26/2024

Die KSAUDIO_PACKETSIZE_CONSTRAINTS2-Struktur beschreibt die physischen Hardwareeinschränkungen. Es enthält ein Array mit mindestens 0 KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT Strukturen, die Einschränkungen beschreiben, die für alle Signalverarbeitungsmodi spezifisch sind. Der Treiber legt diese Eigenschaft fest, bevor PcRegisterSubdevice aufgerufen oder anderweitig seine KS-Filterschnittstelle für die Streamingpins aktiviert wird.

Syntax

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

Member

MinPacketPeriodInHns

Die vom Treiber unterstützte absolute Mindestverarbeitungsdauer, ausgedrückt in Hundert-Nanosekunden-Einheiten (HNS). Dieser Wert kann 0 sein, wenn der Treiber keinen bestimmten Mindestverarbeitungszeitraum hat.

PacketSizeFileAlignment

Die Bytegrößenausrichtungsanforderung. Verwenden Sie einen der folgenden definierten Dateiausrichtungswerte:

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

Die absolute maximale Paketgröße, die vom Treiber in Bytes unterstützt wird. Dies kann null sein, wenn der Treiber keine bestimmte maximale Paketgröße aufweist. Diese Größe sollte mindestens groß genug sein, um einen Puffer von 10 ms eines beliebigen Formats zu unterstützen, das vom Pin unterstützt wird. Diese Größe sollte auch größer oder gleich minPacketSize-Einschränkungen sein.

NumProcessingModeConstraints

Die Anzahl zusätzlicher Einschränkungen für bestimmte Verarbeitungsmodi. Dieser Wert kann 0 sein.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Ein Array mit 0 oder mehr Verarbeitungsmoduseinschränkungen.

Hinweise

Der Treiber legt diese Datenstruktur mit variabler Länge als Wert der DEVPKEY_KsAudio_PacketSize_Constraints2-Eigenschaft auf der PnP-Schnittstelle des KS-Filters fest, der die Streamingpins mit den Einschränkungen aufweist.

Für WaveRT-Treiber beschreibt diese Datenstruktur die Einschränkungen für ein WaveRT-Paket. Mehrere WaveRT-Pakete (in der Regel 2) werden verkettet, um den WaveRT-Puffer zu bilden.

Die KSAUDIO_PACKETSIZE_CONSTRAINTS2-Struktur ist ab Windows 10 Version 1607 verfügbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Kopfzeile	ksmedia.h

Freigeben über