KSAUDIO_PACKETSIZE_CONSTRAINTS2構造体 (ksmedia.h)

[アーティクル]
02/29/2024

KSAUDIO_PACKETSIZE_CONSTRAINTS2構造では、物理ハードウェアの制約について説明します。これは、任意の信号処理モードに固有の制約を記述する0以上の KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT 構造の配列を含む。ドライバーは、PcRegisterSubdevice を呼び出す前に、またはストリーミングピンの KS フィルターインターフェイスを有効にする前に、このプロパティを設定します。

構文

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

メンバー

MinPacketPeriodInHns

100 ナノ秒 (HNS) 単位で表されるドライバーによってサポートされる絶対最小処理期間。ドライバーに特定の最小処理期間がない場合、この値は 0 にすることができます。

PacketSizeFileAlignment

バイトサイズのアラインメント要件。次の定義済みのファイル配置値のいずれかを使用します。

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

ドライバーでサポートされる絶対最大パケットサイズ (バイト単位)。ドライバーに特定の最大パケットサイズがない場合は、0 を指定できます。このサイズは、少なくとも、ピンでサポートされている任意の形式の 10 ミリ秒のバッファーをサポートするのに十分な大きさにする必要があります。このサイズは、MinPacketSize 制約以上である必要もあります。

NumProcessingModeConstraints

特定の処理モードに対する追加の制約の数。この値は 0 にできます。

ProcessingModeConstraints[ANYSIZE_ARRAY]

0 個以上の処理モード制約の配列。

注釈

ドライバーは、この可変長データ構造を、制約付きのストリーミングピンを持つ KS フィルターの PnP インターフェイスの DEVPKEY_KsAudio_PacketSize_Constraints2 プロパティの値として設定します。

WaveRT ドライバーの場合、このデータ構造は WaveRT パケットの制約を記述します。複数の WaveRT パケット (通常は 2) が連結され、WaveRT バッファーが形成されます。

KSAUDIO_PACKETSIZE_CONSTRAINTS2 構造体は、Windows 10 バージョン 1607 以降で使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	Windows Server 2016
Header	ksmedia.h

次の方法で共有