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

  • Artigo

A função RecycleCommandList recicla uma lista de comandos.

Sintaxe

PFND3D11DDI_RECYCLECOMMANDLIST Pfnd3d11ddiRecyclecommandlist;

void Pfnd3d11ddiRecyclecommandlist(
  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 de contexto imediato para os dados privados do driver para que a lista de comandos seja reciclada.

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 RecycleCommandList se o driver der suporte ao bit D3D11DDICAPS_COMMANDLISTS_BUILD_2 threading-capability. O driver pode retornar D3D11DDICAPS_COMMANDLISTS_BUILD_2 no membro Caps da estrutura D3D11DDI_THREADING_CAPS de uma chamada para a função GetCaps(D3D10_2) do driver.

Para obter mais informações sobre RecycleCommandList, consulte Optimization for Small Command Listas.

O driver não deve encontrar nenhum erro, exceto para D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar qualquer 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 precisará retornar D3DDDIERR_DEVICEREMOVED. No entanto, se a remoção do dispositivo interferir na operação de RecycleCommandList (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.

Requisitos

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

Confira também

D3D11DDI_DEVICEFUNCS

D3D11DDI_THREADING_CAPS

GetCaps(D3D10_2)

pfnSetErrorCb