PFND3D11DDI_DESTROYCOMMANDLIST função de retorno de chamada (d3d10umddi.h)

  • Artigo

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.

Retornar valor

Nenhum

Comentários

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 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 precisa 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 do D3D11DDI_DEVICEFUNCS para 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 Listas.

Requisitos

Requisito Valor
Cliente mínimo com suporte O DestroyCommandList tem suporte a partir do sistema operacional Windows 7.
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

CreateCommandList

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb