PFND3DDDI_DECODEEXTENSIONEXECUTE funzione di callback (d3dumddi.h)
La funzione DecodeExtensionExecute esegue un'operazione di decodifica usando il dispositivo di estensione decode directX Video Accelerator (DXVA) specificato.
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 DXVA 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 è riuscito ad allocare la memoria necessaria per il completamento. |
Osservazioni
Un driver di visualizzazione in modalità utente (UMD) può implementare la funzione DecodeExtensionExecute per supportare le estensioni ai tipi di decodifica standard ( ovvero GUID decodifica non standard). Questi tipi di decodifica non standard sono utili per configurare la crittografia e altri miglioramenti vari.
il DecodeExtensionExecute viene chiamato quando i decodificatori DirectX VA 2.0 richiedono le estensioni non standard.
Per la compatibilità con i decodificatori DirectX VA 1.0 che potrebbero richiedere queste estensioni non standard, Viene chiamato il DecodeExtensionExecute ogni volta che un decodificatore DirectX VA 1.0 esegue una chiamata di esecuzione in cui qualsiasi valore bDXVA_Func maggiore di 4 viene impostato nei 8 bit più significativi della funzione membro della struttura D3DDDIARG_DECODEEXTENSIONEXECUTE. il DecodeExtensionExecute viene chiamato anche ogni volta che il decodificatore DirectX VA 1.0 effettua una chiamata di configurazione in cui qualsiasi flag DXVA_ConfigQueryOrReplyFunc diverso da DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) o DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) sia impostato nei 24 bit più significativi di Funzione. Per altre informazioni sui significati delle impostazioni di bit di Function, vedere gli argomenti DXVA_ConfigQueryOrReplyFlag e variabili di DXVA_ConfigQueryorReplyFunc e bDXVA_Func variabile.
A causa di 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 tale chiamata di configurazione anche prima che venga creato un dispositivo decodificato. Se viene eseguita una chiamata di configurazione di questo tipo prima della creazione di un dispositivo decodificato, il membro hDecode della struttura D3DDDIARG_DECODEEXTENSIONEXECUTE a cui punta il parametro pData è impostato su NULL. In questo caso, il driver potrebbe essere necessario per restituire un errore (ad esempio, E_FAIL) se il driver non può supportare la situazione indipendentemente da un dispositivo decodificato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |