PDXVAHDSW_ProposeVideoPrivateFormat fungsi panggilan balik (dxvahd.h)

Artikel
08/23/2023

Mendapatkan format permukaan privat dari perangkat lunak plug-in Microsoft DirectX Video Acceleration High Definition (DXVA-HD).

Sintaks

PDXVAHDSW_ProposeVideoPrivateFormat PdxvahdswProposevideoprivateformat;

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

Parameter

[in] hDevice

Handel ke perangkat DXVA-HD plug-in.

[in, out] pFormat

Penunjuk ke nilai D3DFORMAT . Pada input, menentukan format permukaan yang diminta oleh aplikasi. Pada output, menentukan format permukaan privat yang diusulkan perangkat plug-in.

Menampilkan nilai

Jika fungsi panggilan balik ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini dipanggil ketika aplikasi memanggil IDXVAHD_Device::CreateVideoSurface jika kondisi berikut benar:

Jenis permukaan input DXVAHD_SURFACE_TYPE_VIDEO_INPUT_PRIVATE.
Perangkat Direct3D tidak mendukung format permukaan yang diminta oleh aplikasi secara asli.

Fungsi ini memungkinkan perangkat plug-in untuk mengusulkan format alternatif dengan tata letak memori yang setara. Misalnya, jika aplikasi meminta AYUV, perangkat plug-in mungkin mengalokasikan permukaan jenis D3DFMT_A8R8G8B8.

Jika fungsi berhasil, metode CreateVideoSurface mencoba membuat permukaan dengan format yang dikembalikan dalam pFormat.

Contoh

Kode berikut menunjukkan bagaimana perangkat plug-in mengusulkan D3DFMT_A8R8G8B8 sebagai format permukaan alternatif untuk AYUV.

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

        default: 
            return E_FAIL;
    }
}

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	dxvahd.h

Lihat juga

DXVA-HD

DXVAHDSW_CALLBACKS

IDXVAHD_Device::CreateVideoSurface

Fungsi Media Foundation

Bagikan melalui