PFND3DDDI_DECODEEXTENSIONEXECUTE função de retorno de chamada (d3dumddi.h)
A função DecodeExtensionExecute executa uma operação de decodificação usando o dispositivo de extensão DXVA (Acelerador de Vídeo DirectX) não padrão.
Sintaxe
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [dentro, fora]
Um ponteiro para uma estrutura D3DDDIARG_DECODEEXTENSIONEXECUTE que descreve a operação de decodificação DXVA a ser executada.
Valor de retorno
DecodeExtensionExecute retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | A operação de decodificação de VA do DirectX é executada com êxito. |
| E_OUTOFMEMORY | DecodeExtensionExecute não pôde alocar a memória necessária para que ela fosse concluída. |
Observações
Um UMD (driver de exibição) no modo de usuário pode implementar a função DecodeExtensionExecute para dar suporte a extensões para os tipos de decodificação padrão (ou seja, GUIDs decodificados sem padrão). Esses tipos de decodificação não padrão são úteis para configurar a criptografia e outros aprimoramentos diversos.
DecodeExtensionExecute é chamado quando os decodificadores directX VA 2.0 exigem as extensões não padrão.
Para compatibilidade com decodificadores directx va 1.0 que podem exigir essas extensões não padrão, DecodeExtensionExecute é chamado sempre que um decodificador DirectX VA 1.0 faz uma chamada de execução na qual qualquer valor de bDXVA_Func maior que 4 é definido nos 8 bits mais significativos da função membro da estrutura D3DDDIARG_DECODEEXTENSIONEXECUTE. DecodeExtensionExecute também é chamado sempre que o decodificador DirectX VA 1.0 faz uma chamada de configuração na qual qualquer sinalizador de DXVA_ConfigQueryOrReplyFunc que não seja DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) ou DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) é definido nos 24 bits mais significativos do de Função. Para obter mais informações sobre os significados das configurações de bit de Function, consulte os tópicos DXVA_ConfigQueryOrReplyFlag e DXVA_ConfigQueryorReplyFunc Variables e bDXVA_Func Variable.
Devido a problemas de compatibilidade com decodificadores directX VA 1.0 que podem fazer essa chamada de configuração antes de DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY, esses decodificadores podem fazer essa chamada de configuração também antes de um dispositivo de decodificação ser criado. Se essa chamada de configuração for feita antes que um dispositivo decodificado seja criado, o hDecode membro da estrutura D3DDDIARG_DECODEEXTENSIONEXECUTE à qual o parâmetro pData aponta é definido como NULL. Nessa situação, o driver pode ser necessário para retornar um erro (por exemplo, E_FAIL) se o driver não puder dar suporte à situação independentemente de um dispositivo decodificado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |