KSAUDIO_PACKETSIZE_CONSTRAINTS-Struktur (ksmedia.h)

  • Artikel

Die KSAUDIO_PACKETSIZE_CONSTRAINTS-Struktur beschreibt die physischen Hardwareeinschränkungen. Es enthält ein Array von 0 oder mehr 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_CONSTRAINTS {
  ULONG                                        MinPacketPeriodInHns;
  ULONG                                        PacketSizeFileAlignment;
  ULONG                                        Reserved;
  ULONG                                        NumProcessingModeConstraints;
  KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT ProcessingModeConstraints[ANYSIZE_ARRAY];
} KSAUDIO_PACKETSIZE_CONSTRAINTS;

Member

MinPacketPeriodInHns

Die absolute Mindestverarbeitungsdauer, die vom Treiber unterstützt wird, 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

Reserved

Nicht verwendet.

NumProcessingModeConstraints

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

ProcessingModeConstraints[ANYSIZE_ARRAY]

Ein Array von 0 oder mehr Verarbeitungsmoduseinschränkungen.

Hinweise

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

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.

Anforderungen

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

Weitere Informationen

KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT

PcRegisterSubdevice