共用方式為

PDD_VPORTCB_GETINPUTFORMATS回呼函式 (ddrawint.h)

  • 發行項

DdVideoPortGetInputFormats回呼函式會決定 DirectDraw VPE 物件可以接受的輸入格式。

語法

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

參數

unnamedParam1

指向 DD_GETVPORTINPUTFORMATDATA 結構，其中包含驅動程式傳回 VPE 物件可接受之輸入格式所需的資訊。

傳回值

DdVideoPortGetInputFormats 會傳回下列其中一個回呼代碼：

備註

DdVideoPortGetInputFormats 必須在支援 VPE 的 DirectDraw 驅動程式中實作。

DirectDraw 會呼叫 DdVideoPortGetInputFormats ，以取得指定 VPE 物件所支援的輸入格式數目，以及每個格式的描述。 指定的 VPE 物件會呼叫DdVideoPortGetInputFormats兩次：

  • 在第一次呼叫中，lpGetInputFormats上DD_GETVPORTINPUTFORMATDATA結構的lpddpfFormat成員是Null。 驅動程式應該寫入 VPE 物件在 dwNumFormats 成員中支援DD_GETVPORTINPUTFORMATDATA的輸入格式數目。 傳回時，DirectDraw 會配置這個數目的 DDPIXELFORMAT 結構，以第二次呼叫 DdVideoPortGetInputFormats。
  • 第二次呼叫中， lpddpfFormat 會指向已配置之 DDPIXELFORMAT 結構的陣列。 驅動程式應該填入每個結構，以描述 VPE 物件支援的每個輸入格式。 驅動程式也應該傳回 dwNumFormats中支援的輸入格式數目。 請注意，驅動程式保證 lpddpfFormat 指向的緩衝區夠大，足以保存所要求的格式資訊。
如果DD_GETVPORTINPUTFORMATDATA結構的 dwFlags 成員只設定為DDVPFORMAT_VIDEO，驅動程式應該只傳回一般視訊資料支援的格式。 如果 dwFlags 只設定為 DDVPFORMAT_VBI，驅動程式應該只傳回 VBI 資料支援的格式。 如果 dwFlags 設定為這兩個旗標，驅動程式應該會傳回 VPE 物件支援的所有格式。

需求

   
目標平台 桌面
標頭 ddrawint.h (包含 Winddi.h)

另請參閱

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA