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:

Código devuelto	Descripción
S_OK	El nombre del recurso se ha cambiado correctamente.
E_OUTOFMEMORY	El cambio de nombre no pudo asignar la memoria necesaria para que se complete.

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

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

Cambiar nombre