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 decodificação não padrão do Microsoft DirectX Video Accelerator (VA).
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 [in, out]
Um ponteiro para uma estrutura D3DDDIARG_DECODEEXTENSIONEXECUTE que descreve a operação de decodificação de VA do DirectX a ser executada.
Retornar valor
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. |
Comentários
Um 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 não 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 do membro Function 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 da Função. Para obter mais informações sobre os significados para as configurações de bit da Função, consulte os tópicos variáveis de DXVA_ConfigQueryOrReplyFlag e DXVA_ConfigQueryorReplyFunc e variáveis bDXVA_Func .
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 da criação de um dispositivo de decodificação, o membro hDecode da estrutura D3DDDIARG_DECODEEXTENSIONEXECUTE para a qual o parâmetro pData aponta será definido como NULL. Nessa situação, o driver poderá 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 |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |