PFND3DDDI_RENAME función de devolución de llamada (d3dumddi.h)

La función Rename informa a un controlador de pantalla en modo de usuario para empezar a usar la asignación con nombre que la función LockAsync devolvió anteriormente para el recurso especificado.

Sintaxis

PFND3DDDI_RENAME Pfnd3dddiRename;

HRESULT Pfnd3dddiRename(
  HANDLE hDevice,
  const D3DDDIARG_RENAME *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador de un dispositivo de visualización (es decir, el contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDIARG_RENAME que describe el recurso o la superficie de un recurso para cambiar el nombre con una nueva asignación.

Valor devuelto

Rename devuelve uno de los valores siguientes:

Comentarios

En equipos con varios procesadores, el tiempo de ejecución de Microsoft Direct3D llama a la función Rename del controlador de pantalla en modo de usuario desde un subproceso de trabajo en lugar de desde el subproceso de aplicación principal. El tiempo de ejecución llama a Rename, como máximo, una vez para cada llamada correcta a la función LockAsync del controlador con la marca Descartar campo de bits establecida en el miembro Flags de la estructura D3DDDIARG_LOCKASYNC a la que apunta el parámetro pData de LockAsync .

Cambiar nombre informa al controlador para empezar a usar la asignación cuyo nombre ha especificado el miembro hCookie de la estructura D3DDDIARG_RENAME a la que apunta el parámetro pData de Rename . La función LockAsync devolvió previamente el identificador hCookie si se estableció la marca descartar campo de bits para el recurso bloqueado.

Después de que Rename se devuelva correctamente (con S_OK), el controlador de visualización en modo de usuario debe usar la asignación que hCookie especifica para todas las operaciones de representación que hacen referencia al recurso que especifican los miembros hResource y SubResourceIndex de D3DDDIARG_RENAME.

Requisitos

Consulte también

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

Cambiar nombre