KSAUDIO_PACKETSIZE_CONSTRAINTS2構造体 (ksmedia.h)
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 |
ヘッダー | ksmedia.h |