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

Artigo
02/22/2024

A função CreateCommandList cria uma lista de comandos.

Sintaxe

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

void Pfnd3d11ddiCreatecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
  D3D11DDI_HCOMMANDLIST unnamedParam3,
  D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}

Parâmetros

unnamedParam1

hDevice [in]

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pCreateCommandList [in]

Um ponteiro para uma estrutura D3D11DDIARG_CREATECOMMANDLIST que descreve os parâmetros que o driver de exibição do modo de usuário usa para criar uma lista de comandos.

unnamedParam3

hCommandList [in]

Um identificador para os dados privados do driver para a lista de comandos.

unnamedParam4

hRTCommandList [in]

Um identificador para a lista de comandos que o driver deve usar quando ele chama de volta para o runtime do Direct3D.

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 CreateCommandList 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 pode passar E_OUTOFMEMORY (se o driver ficar sem memória) ou D3DDDIERR_DEVICEREMOVED (se o dispositivo for removido) em uma chamada para a função pfnSetErrorCb . O runtime do Direct3D determina que quaisquer outros erros são críticos. Se o driver passar por erros, o que inclui D3DDDIERR_DEVICEREMOVED, o runtime do Direct3D determinará que o identificador é inválido; portanto, o runtime não chama a função DestroyCommandList para destruir o identificador especificado pelo parâmetro hCommandList .

Requisitos

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