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
Header ksmedia.h