共用方式為

PDD_VPORTCB_GETOUTPUTFORMATS回呼函式 (ddrawint.h)

  • 發行項

DdVideoPortGetOutputFormats回呼函式會決定 VPE 物件支援的輸出格式。

語法

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

參數

unnamedParam1

指向 DD_GETVPORTOUTPUTFORMATDATA 結構，其中包含驅動程式傳回 VPE 物件支援的輸出格式所需的資訊。

傳回值

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

備註

支援 VPE 的 DirectDraw 驅動程式必須實作 DdVideoPortGetOutputFormats

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

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

需求

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

另請參閱

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA