PFND3D11DDI_DESTROYCOMMANDLIST função de retorno de chamada (d3d10umddi.h)
A função DestroyCommandList destrói uma lista de comandos.
Sintaxe
PFND3D11DDI_DESTROYCOMMANDLIST Pfnd3d11ddiDestroycommandlist;
void Pfnd3d11ddiDestroycommandlist(
D3D10DDI_HDEVICE unnamedParam1,
D3D11DDI_HCOMMANDLIST unnamedParam2
)
{...}
Parâmetros
unnamedParam1
hDevice [in]
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
hCommandList [in]
Um identificador para os dados privados do driver para a lista de comandos a ser destruída. O runtime do Microsoft Direct3D libera a região de memória alocada anteriormente para a lista de comandos. Portanto, o driver não pode mais acessar essa região de memória.
Valor de retorno
Nenhum
Observações
O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.
O driver só será necessário para implementar DestroyCommandList se o driver der suporte à funcionalidade de D3D11DDICAPS_COMMANDLISTS_BUILD_2 que pode ser retornada na estrutura D3D11DDI_THREADING_CAPS de uma chamada para a função getcaps(D3D10_2).
O driver não deve encontrar nenhum erro, exceto por D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar algum erro, exceto por D3DDDIERR_DEVICEREMOVED, em uma chamada para a função pfnSetErrorCb, o runtime do Direct3D determinará que o erro é crítico. Mesmo que o dispositivo seja removido, o driver não será necessário para retornar D3DDDIERR_DEVICEREMOVED; no entanto, se a remoção do dispositivo interferir na operação de DestroyCommandList (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.
O driver pode implementar uma função DestroyCommandList que contém uma instrução switch para processar a destruição de listas de comandos e a destruição leve de listas de comandos. Ou seja, o driver pode implementar um DestroyCommandList e pode definir o membro pfnRecycleDestroyCommandList da estrutura D3D11DDI_DEVICEFUNCS para apontar para DestroyCommandList juntamente com o membro pfnRecycleDestroyCommandList de D3D11DDI_DEVICEFUNCS apontar para DestroyCommandList. No entanto, para melhorar o desempenho, o driver pode implementar funções DestroyCommandList e RecycleDestroyCommandList separadas.
Para obter mais informações sobre RecycleDestroyCommandList, consulte Optimization for Small Command Lists.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O DestroyCommandList tem suporte a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3d10umddi.h (inclua D3d10umddi.h) |