KS_VIDEOINFOHEADER2 結構 (ksmedia.h)

  • 發行項

KS_VIDEOINFOHEADER2結構描述視訊數據流的詳細數據，包括bob或 weave 設定、複製保護和像素外觀比例。

語法

typedef struct tagKS_VIDEOINFOHEADER2 {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  DWORD               dwInterlaceFlags;
  DWORD               dwCopyProtectFlags;
  DWORD               dwPictAspectRatioX;
  DWORD               dwPictAspectRatioY;
  union {
    DWORD dwControlFlags;
    DWORD dwReserved1;
  };
  DWORD               dwReserved2;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER2, *PKS_VIDEOINFOHEADER2;

成員

rcSource

指定要使用中視訊訊號部分的裁剪矩形。

rcTarget

指定矩形，指出要使用的目標緩衝區部分。

dwBitRate

指定值，指出視訊數據流的適當數據速率，以每秒的位數為單位。

dwBitErrorRate

指定值，指出視訊數據流的數據錯誤率，以每秒的位錯誤為單位。

AvgTimePerFrame

以100奈秒為單位指定每個畫面的平均時間。

dwInterlaceFlags

指定交錯資訊。 未定義的旗標必須設定為零，否則可能會拒絕連線。 這個成員可以設定為 ksmedia.h 中定義的一或多個 (邏輯 OR) 值：

旗標 描述
KS_INTERLACE_IsInterlaced 表示交錯數據流。 如果為 0，則其他KS_INTERLACE_Xxx位無關。
KS_INTERLACE_1FieldPerSample 指出每個媒體範例一個字段。 如果為零，則表示每個媒體範例的兩個字段。
KS_INTERLACE_Field1First 表示第一個字段 1。 如果為零，表示第一個字段 2。 PAL 中的頂端欄位是欄位 1，NTSC 中的頂端欄位是欄位 2。
KS_INTERLACE_UNUSED 未使用
KS_INTERLACE_FieldPatternMask 指出用來指定欄位模式的位。
KS_INTERLACE_FieldPatField1Only 表示數據流永遠不會包含欄位 2。
KS_INTERLACE_FieldPatField2Only 表示數據流永遠不會包含欄位 1。
KS_INTERLACE_FieldPatBothRegular 表示每個欄位 1 會有一個字段 2。
KS_INTERLACE_FieldPatBothIrregular 表示欄位 1 和欄位 2 的隨機模式。
KS_INTERLACE_DisplayModeMask 視訊擷取無效。
KS_INTERLACE_DisplayModeBobOnly 視訊擷取無效。
KS_INTERLACE_DisplayModeWeaveOnly 視訊擷取無效。
KS_INTERLACE_DisplayModeBobOrWeave 視訊擷取無效。

dwCopyProtectFlags

指定 KSCOPYPROTECTRestrictDuplication 值 (0x00000001) ，以指出是否應限制數據流重複。 如果未定義，請指定零或將拒絕連接。

dwPictAspectRatioX

指定圖片外觀比例的 x 維度 (例如，16 × 9 顯示) 的 16。 此值以英吋為單位來表示，而不是以圖元為單位。

dwPictAspectRatioY

指定圖片外觀比例的 y 維度 (例如，9 表示 16 × 9 顯示) 。 此值以英吋為單位來表示，而不是以圖元為單位。

dwControlFlags

在 Windows Vista 之前的操作系統中，此成員的名稱為 dwReserved1 ，而且必須是零。 在 Windows Vista 中， dwReserved1 會與名為 dwControlFlags 的新成員結合在一起。 如果使用， dwControlFlags 會包含下表中旗標的位 OR。

值 Description
AMCONTROL_USED 表示使用 dwControlFlags 旗標 。
AMCONTROL_PAD_TO_4x3 影像應該填補並顯示在 4 x 3 區域中。
AMCONTROL_PAD_TO_16x9 影像應該填補並顯示在16 x9區域中。
AMCONTROL_COLORINFO_PRESENT 其他色彩資訊包含在 dwControlFlags 字段的上方 24 位中。

AMCONTROL_USED旗標提供與舊版篩選條件的回溯相容性。 如果未設定AMCONTROL_USED旗標，則應該忽略此欄位中的其餘位。 如果篩選條件使用任何其他旗標，它應該設定AMCONTROL_USED旗標。

譯碼器會使用兩個AMCONTROL_PAD_xxx旗標來判斷輸出矩形的外觀比例。

如果已設定AMCONTROL_COLORINFO_PRESENT旗標，表示 dwControlFlags 字段的上方 24 位會被視為 DXVA_ExtendedFormat 結構。

如需 dwControlFlags 的詳細資訊，請參閱本主題稍後的一節。

dwReserved1

此成員適用於回溯相容性。 如需詳細資訊 ，請參閱 dwControlFlags 。

dwReserved2

保留供系統使用。 必須設定為零，否則將會拒絕連線。

bmiHeader

指出 KS_BITMAPINFOHEADER 結構，其中包含視訊影像位圖的色彩和維度資訊。

備註

若要描述沒有 bob 或 weave 設定的視訊串流，請使用 KS_VIDEOINFOHEADER。

KS_VIDEOINFOHEADER2 結構與 DirectShow VIDEOINFOHEADER2 結構相同。

擷取產生視訊欄位的迷你驅動程式 (，而不是畫面) 必須使用包含 KS_VIDEOINFOHEADER2結構的KS_DATARANGE_VIDEO2 結構。

來源篩選條件可以藉由提供有效定義 rcSource 成員中裁剪矩形的值，要求接收篩選只接受視訊的區段。 不過，如果接收篩選未檢查連接上的裁剪矩形，接收篩選只會轉譯所有視訊，有效地忽略從來源篩選傳遞至接收篩選的任何裁剪資訊。

在理想情況下，接收篩選器會檢查 rcSource ，如果接收篩選不支援影像擷取，而且矩形 不是 空的，則會拒絕連線。 篩選條件應該使用 Win32 函數 SetRectEmpty 將矩形重設為所有零 (，並將 IsRectEmpty 設定為稍後檢查矩形) 。

rcTarget 成員會指定影片的目的地矩形。 大部分的來源篩選會將此成員設定為所有零。 下游篩選條件可以要求將視訊放在它提供之緩衝區的特定區域中。 在此情況下，它會使用無空目標呼叫 Win32 函式 QueryAccept 。

如果在 dwControlFlags 成員中設定AMCONTROL_COLORINFO_PRESENT旗標，您可以將 dwControlFlags 值轉換成 DXVA_ExtendedFormat 結構，以存取延伸色彩資訊。 如需詳細資訊，請參閱 VIDEOINFOHEADER2。

規格需求

需求 值
標頭 ksmedia.h (包含 Ksmedia.h)

另請參閱

KS_BITMAPINFOHEADER

KS_DATARANGE_VIDEO2

KS_VIDEOINFOHEADER