PFND3DDDI_RENAME função de retorno de chamada (d3dumddi.h)

A função Rename informa um driver de exibição do modo de usuário para começar a usar a alocação renomeada que a função LockAsync retornou 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.

Retornar valor

Rename retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	O recurso foi renomeado com êxito.
E_OUTOFMEMORY	A renomeação não pôde alocar a memória necessária para que ela fosse concluída.

Comentários

Em computadores com vários processadores, o runtime do Microsoft Direct3D chama a função Renomear do driver de exibição do modo de usuário de um thread de trabalho em vez de do thread de aplicativo main. O runtime chama Renomear, no máximo, uma vez para cada chamada bem-sucedida para a função LockAsync do driver com o sinalizador Descartar campo de bit definido no membro Flags da estrutura D3DDDIARG_LOCKASYNC para a qual o parâmetro pData de LockAsync aponta.

Renomear informa o driver para começar a usar a alocação renomeada especificada pelo membro hCookie da estrutura D3DDDIARG_RENAME para a qual o parâmetro pData de Rename aponta. O identificador hCookie foi retornado anteriormente pela função LockAsync se o sinalizador Descartar campo de bits foi definido para o recurso bloqueado.

Depois que Rename retornar com êxito (com S_OK), o driver de exibição do modo de usuário deve usar a alocação especificada por hCookie para todas as operações de renderização que referenciam o recurso que os membros hResource e SubResourceIndex de D3DDDIARG_RENAME especificar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

Renomear