共用方式為

PDXVAHDSW_ProposeVideoPrivateFormat回呼函式 (dxvahd.h)

  • 發行項

從軟體外掛程式 Microsoft DirectX 影片加速高定義 (DXVA-HD) 裝置取得私人介面格式。

語法

PDXVAHDSW_ProposeVideoPrivateFormat PdxvahdswProposevideoprivateformat;

HRESULT PdxvahdswProposevideoprivateformat(
  [in]      HANDLE hDevice,
  [in, out] D3DFORMAT *pFormat
)
{...}

參數

[in] hDevice

外掛程式 DXVA-HD 裝置的控制碼。

[in, out] pFormat

D3DFORMAT值的指標。 在輸入上，指定應用程式所要求的介面格式。 在輸出中，指定外掛程式裝置所建議的私人介面格式。

傳回值

如果此回呼函式成功，它會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果下列條件成立，當應用程式呼叫 IDXVAHD_Device：：CreateVideoSurface 時，就會呼叫此函式：

  • 輸入介面的類型 DXVAHD_SURFACE_TYPE_VIDEO_INPUT_PRI加值稅E。
  • Direct3D 裝置不支援原生應用程式所要求的介面格式。
此函式可讓外掛程式裝置建議具有對等記憶體配置的替代格式。 例如，如果應用程式要求 AYUV，外掛程式裝置可能會配置類型 為 D3DFMT_A8R8G8B8的介面。

如果函式成功， CreateVideoSurface 方法會嘗試使用 pFormat中傳回的格式來建立介面。

範例

下列程式碼示範外掛程式裝置如何建議 D3DFMT_A8R8G8B8 作為 AYUV 的替代介面格式。

HRESULT CALLBACK ProposeVideoPrivateFormat(
    HANDLE hDevice,
    D3DFORMAT* pFormat 
    )
{
    switch (*pFormat)
    {
        case D3DFMT_AYUV: 
            *pFormat = D3DFMT_A8R8G8B8; 
            return S_OK;

        default: 
            return E_FAIL;
    }
}

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 dxvahd.h

另請參閱

DXVA-HD

DXVAHDSW_CALLBACKS

IDXVAHD_Device：：CreateVideoSurface

媒體基礎函式