PDXVAHDSW_ProposeVideoPrivateFormat Rückruffunktion (dxvahd.h)
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.
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 |