PFND3DDDI_DECODEEXTENSIONEXECUTE funzione di callback (d3dumddi.h)

  • Articolo

La funzione DecodeExtensionExecute esegue un'operazione di decodifica usando il dispositivo di decodifica non standard Microsoft DirectX Video Accelerator (VA).

Sintassi

PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;

HRESULT Pfnd3dddiDecodeextensionexecute(
  HANDLE hDevice,
  const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_DECODEEXTENSIONEXECUTE che descrive l'operazione di decodifica DirectX VA da eseguire.

Valore restituito

DecodeExtensionExecute restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK L'operazione di decodifica DirectX VA viene eseguita correttamente.
E_OUTOFMEMORY DecodeExtensionExecute non è stato possibile allocare la memoria necessaria per il completamento.

Commenti

Un driver di visualizzazione in modalità utente può implementare la funzione DecodeExtensionExecute per supportare le estensioni ai tipi di decodifica standard, ovvero GUID non standard. Questi tipi di decodifica non standard sono utili per configurare la crittografia e altri miglioramenti vari.

DecodeExtensionExecute viene chiamato quando i decodificatori DirectX VA 2.0 richiedono le estensioni non standard.

Per la compatibilità con decodificatori DirectX VA 1.0 che potrebbero richiedere queste estensioni non standard, DecodeExtensionExecute viene chiamato ogni volta che un decodificatore DirectX VA 1.0 effettua una chiamata di esecuzione in cui qualsiasi valore bDXVA_Func maggiore di 4 è impostato nei 8 bit più significativi del membro funzionedella struttura D3DDDIARG_DECODEEXTENSIONEXECUTE. DecodeExtensionExecute viene chiamato anche ogni volta che il decodificatore DirectX VA 1.0 effettua una chiamata di configurazione in cui qualsiasi flag di DXVA_ConfigQueryOrReplyFunc diverso da DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) o DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) viene impostato nei più significativi 24 bit della funzione. Per altre informazioni sui significati per le impostazioni bit della funzione, vedere gli argomenti DXVA_ConfigQueryOrReplyFlage variabili DXVA_ConfigQueryorReplyFunc e variabili bDXVA_Func.

A causa dei problemi di compatibilità con i decodificatori DirectX VA 1.0 che potrebbero effettuare una chiamata di configurazione di questo tipo prima di DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY, tali decodificatori possono effettuare una chiamata di configurazione anche prima che venga creato un dispositivo di decodifica. Se tale chiamata di configurazione viene eseguita prima della creazione di un dispositivo di decodifica, il membro hDecode della struttura D3DDDIARG_DECODEEXTENSIONEXECUTE a cui punta il parametro pData è impostato su NULL. In questa situazione, il driver potrebbe essere necessario restituire un errore (ad esempio, E_FAIL) se il driver non può supportare la situazione indipendentemente da un dispositivo di decodifica.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDIARG_DECODEEXTENSIONEXECUTE

D3DDDI_DEVICEFUNCS