KSAUDIO_PACKETSIZE_CONSTRAINTS構造体 (ksmedia.h)

[アーティクル]
02/07/2025

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

構文

typedef struct _KSAUDIO_PACKETSIZE_CONSTRAINTS {
  ULONG                                        MinPacketPeriodInHns;
  ULONG                                        PacketSizeFileAlignment;
  ULONG                                        Reserved;
  ULONG                                        NumProcessingModeConstraints;
  KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT ProcessingModeConstraints[ANYSIZE_ARRAY];
} KSAUDIO_PACKETSIZE_CONSTRAINTS;

メンバーズ

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

Reserved

未使用。

NumProcessingModeConstraints

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

ProcessingModeConstraints[ANYSIZE_ARRAY]

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

備考

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 10
サポートされる最小サーバー	Windows Server 2016
ヘッダー	ksmedia.h

次の方法で共有