PFND3DDDI_DEALLOCATE2CB función de devolución de llamada (d3dumddi.h)
El pfnDeallocate2Cb función de devolución de llamada del modo de usuario 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 marcas se establecen en todos los ceros, el comportamiento equivale 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 D3DDDICB_DEALLOCATE2 que describe el recurso que se va a liberar.
Valor devuelto
| Código devuelto | Descripción |
|---|---|
| S_OK | La memoria se ha liberado correctamente. |
| E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
Esta función también puede devolver otros valores HRESULT.
Observaciones
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 tener acceso a la asignación que se va a destruir y aplazar 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 pfnDeallocate2Cb llamada (por ejemplo, para minimizar el uso máximo de memoria si se vuelve a crear la superficie), debe establecer la marca synchronousDestroy.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |