PDXVAHDSW_ProposeVideoPrivateFormat Rückruffunktion (dxvahd.h)

Artikel
08/23/2023

Ruft ein privates Surface-Format von einem Microsoft DirectX Video Acceleration High Definition-Gerät (DXVA-HD) ab.

Syntax

PDXVAHDSW_ProposeVideoPrivateFormat PdxvahdswProposevideoprivateformat;

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

Parameter

[in] hDevice

Ein Handle für das DXVA-HD-Plug-In-Gerät.

[in, out] pFormat

Ein Zeiger auf einen D3DFORMAT-Wert . Gibt bei der Eingabe das Oberflächenformat an, das von der Anwendung angefordert wird. Gibt bei der Ausgabe das Private Surface-Format an, das das Plug-In-Gerät vorschlägt.

Rückgabewert

Wenn diese Rückruffunktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion wird aufgerufen, wenn die Anwendung IDXVAHD_Device::CreateVideoSurface aufruft, wenn die folgenden Bedingungen erfüllt sind:

Der Typ der Eingabeoberfläche ist DXVAHD_SURFACE_TYPE_VIDEO_INPUT_PRIVATE.
Das Direct3D-Gerät unterstützt das von der Anwendung nativ angeforderte Oberflächenformat nicht.

Mit dieser Funktion kann das Plug-In-Gerät ein alternatives Format mit einem gleichwertigen Speicherlayout vorschlagen. Wenn die Anwendung beispielsweise AYUV anfordert, kann das Plug-In-Gerät eine Oberfläche vom Typ D3DFMT_A8R8G8B8 zuordnen.

Wenn die Funktion erfolgreich ist, versucht die CreateVideoSurface-Methode , eine Oberfläche mit dem in pFormat zurückgegebenen Format zu erstellen.

Beispiele

Der folgende Code zeigt, wie ein Plug-In-Gerät D3DFMT_A8R8G8B8 als alternatives Oberflächenformat für AYUV vorschlägt.

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

        default: 
            return E_FAIL;
    }
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dxvahd.h

Weitere Informationen

DXVA-HD

DXVAHDSW_CALLBACKS

IDXVAHD_Device::CreateVideoSurface

Media Foundation-Funktionen

Freigeben über