PFND3DDDI_DEALLOCATE2CB función de devolución de llamada (d3dumddi.h)
La función de devolución de llamada del modo de usuario pfnDeallocate2Cb libera asignaciones para un objeto de recurso en modo kernel si se creó el objeto de recurso.
pfnDeallocate2Cb es un reemplazo de pfnDeallocateCb que tiene un miembro Flags adicional. Cuando las marcas se establecen en todos los ceros, el comportamiento es equivalente a pfnDeallocateCb.
Sintaxis
PFND3DDDI_DEALLOCATE2CB Pfnd3dddiDeallocate2cb;
HRESULT Pfnd3dddiDeallocate2cb(
HANDLE hDevice,
const D3DDDICB_DEALLOCATE2 *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in]
Puntero a una estructura de D3DDDICB_DEALLOCATE2 que describe el recurso que se va a liberar.
Valor devuelto
Código devuelto | Descripción |
---|---|
S_OK | La memoria se liberó correctamente. |
E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
Esta función también podría devolver otros valores HRESULT.
Comentarios
Cuando se recibe una solicitud de destrucción de asignación, VidMm asume, de forma predeterminada, que los comandos en cola antes de la solicitud de destrucción pueden acceder a la asignación que se destruye y aplaza la operación de destrucción hasta que finalicen los comandos en cola. Si el controlador en modo de usuario (UMD) sabe que los comandos pendientes no tienen acceso a la asignación que se está destruyendo, puede indicar a VidMm que no espere hasta que finalicen los comandos pendientes estableciendo la marca AssumeNotInUse en TRUE al llamar a pfnDeallocate2Cb.
Si una aplicación o UMD desea asegurarse de que la memoria de asignación se recupera antes de la devolución de la llamada pfnDeallocate2Cb (por ejemplo, para minimizar el uso máximo de memoria si se vuelve a crear la superficie), debe establecer la marca SynchronousDestroy .
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 10 |
Servidor mínimo compatible | Windows Server 2016 |
Plataforma de destino | Escritorio |
Encabezado | d3dumddi.h (incluya D3dumddi.h) |