PFND3DDDI_RENAME função de retorno de chamada (d3dumddi.h)
A função Renomear informa um driver de exibição no modo de usuário para começar a usar a alocação renomeada que a função LockAsync retornada anteriormente para o recurso especificado.
Sintaxe
PFND3DDDI_RENAME Pfnd3dddiRename;
HRESULT Pfnd3dddiRename(
HANDLE hDevice,
const D3DDDIARG_RENAME *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para um dispositivo de exibição (ou seja, o contexto gráfico).
unnamedParam2
pData [in]
Um ponteiro para uma estrutura D3DDDIARG_RENAME que descreve o recurso ou a superfície dentro de um recurso a ser renomeado com uma nova alocação.
Valor de retorno
Renomear retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O recurso é renomeado com êxito. |
| E_OUTOFMEMORY | Não foi possível renomear a memória necessária para que ela seja concluída. |
Observações
Em computadores com vários processadores, o runtime do Microsoft Direct3D chama o driver de exibição do modo de usuário Renomear função de um thread de trabalho em vez do thread principal do aplicativo. As chamadas de runtime Renomear, no máximo, uma vez para cada chamada bem-sucedida para a função LockAsync do driver com o sinalizador de campo de bits descartar definido no membro sinalizadores da estrutura D3DDDIARG_LOCKASYNC para o qual o parâmetro pData de lockAsync aponta.
Renomear informa ao driver para começar a usar a alocação renomeada especificada pelo membro hCookie da estrutura D3DDDIARG_RENAME para o qual o parâmetro pData de Renomear aponta. O identificador hCookie foi retornado anteriormente pela função LockAsync se o sinalizador de Descartar campo de bits foi definido para o recurso bloqueado.
Depois que Renomear retornar com êxito (com S_OK), o driver de exibição no modo de usuário deve usar a alocação que hCookie especifica para todas as operações de renderização que referenciam o recurso que o hResource e subResourceIndex membros de D3DDDIARG_RENAME especificar.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |