PFND3DDDI_RENAME función de devolución de llamada (d3dumddi.h)
La función Cambiar nombre informa a un controlador de pantalla en modo de usuario para empezar a usar la asignación cuyo nombre ha cambiado que la función LockAsync ha devuelto previamente 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 dentro de un recurso para cambiar el nombre con una nueva asignación.
Valor devuelto
Cambiar nombre devuelve uno de los siguientes valores:
| 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. |
Observaciones
En equipos con varios procesadores, el entorno de ejecución de Microsoft Direct3D llama al controlador de pantalla en modo de usuario cambiar el nombre función de un subproceso de trabajo en lugar del subproceso de aplicación principal. El tiempo de ejecución llama Cambiar nombre, como máximo, una vez por cada llamada correcta a la función lockAsync del controlador con la marca de descartar campo de bits establecida en el miembro Flags miembro 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 hCookie miembro de la estructura D3DDDIARG_RENAME a la que apunta el parámetro pData de Cambiar nombre de. La función LockAsync devolvió el identificador de hCookie si se estableció la marca de campo de bits para el recurso bloqueado.
Después de Cambiar nombre devuelve correctamente (con S_OK), el controlador de pantalla 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 hResource y SubResourceIndex miembros de D3DDDIARG_RENAME especifique.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |