PFND3D11DDI_DESTROYCOMMANDLIST función de devolución de llamada (d3d10umddi.h)
La función DestroyCommandList destruye una lista de comandos.
Sintaxis
PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;
void Pfnd3d11ddiDestroycommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
Parámetros
unnamedParam1
hDevice [in]
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
hCommandList [in]
Identificador de los datos privados del controlador para que se destruya la lista de comandos. El entorno de ejecución de Microsoft Direct3D libera la región de memoria que asignó anteriormente para la lista de comandos. Por lo tanto, el controlador ya no puede acceder a esta región de memoria.
Valor devuelto
None
Observaciones
El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.
El controlador solo es necesario para implementar DestroyCommandList si el controlador admite la funcionalidad D3D11DDICAPS_COMMANDLISTS_BUILD_2 que se puede devolver en la estructura de D3D11DDI_THREADING_CAPS desde una llamada a la función GetCaps(D3D10_2).
El controlador no debe encontrar ningún error, excepto por D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa algún error, excepto por D3DDDIERR_DEVICEREMOVED, en una llamada a la función pfnSetErrorCb , el tiempo de ejecución de Direct3D determina que el error es crítico. Incluso si se quita el dispositivo, no es necesario que el controlador devuelva D3DDDIERR_DEVICEREMOVED; Sin embargo, si la eliminación del dispositivo interfiere con el funcionamiento de DestroyCommandList (que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.
El controlador puede implementar una función DestroyCommandList que contiene una instrucción switch para procesar la destrucción de listas de comandos y la destrucción ligera de listas de comandos. Es decir, el controlador puede implementar un DestroyCommandList y puede establecer el miembro pfnRecycleDestroyCommandList de la estructura D3D11DDI_DEVICEFUNCS para que apunte a DestroyCommandList junto con el miembro pfnRecycleDestroyCommandList de D3D11DDI_DEVICEFUNCS para que apunte a DestroyCommandList. Sin embargo, para mejorar el rendimiento, el controlador puede implementar funciones DestroyCommandList y RecycleDestroyCommandList independientes.
Para obtener más información sobre RecycleDestroyCommandList, vea Optimización para el Listas de comandos pequeños.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | DestroyCommandList se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3d10umddi.h (incluya D3d10umddi.h) |