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) |