DXGKDDI_CREATECONTEXT função de retorno de chamada (d3dkmddi.h)

A função DxgkDdiCreateContext cria um contexto de GPU (unidade de processamento gráfico).

Sintaxe

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

Parâmetros

[in] hDevice

Um identificador para o dispositivo de contexto gráfico no qual o novo contexto é criado. A função DxgkDdiCreateDevice do driver de miniporta de vídeo forneceu anteriormente esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no membro hDevice da estrutura DXGKARG_CREATEDEVICE .

[in/out] pCreateContext

Um ponteiro para uma estrutura DXGKARG_CREATECONTEXT que contém informações sobre como criar o contexto.

Retornar valor

DxgkDdiCreateContext retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	DxgkDdiCreateContext criou com êxito o contexto.
STATUS_NO_MEMORY	DxgkDdiCreateContext não pôde alocar a memória necessária para que ela fosse concluída.
STATUS_GRAPHICS_DRIVER_MISMATCH	O driver de miniporta de exibição não é compatível com o driver de exibição do modo de usuário que iniciou a chamada para DxgkDdiCreateContext.

Comentários

Um driver usa um contexto de GPU para manter uma coleção de estado de renderização.

Um único processo pode criar vários contextos em um determinado dispositivo.

O driver deve dar suporte a um número arbitrário de contextos. O único motivo válido pelo qual um driver não pôde criar um contexto é se a memória do sistema se esgota.

Normalmente, cada contexto pode referenciar qualquer recurso criado anteriormente para o dispositivo que possui esse contexto.

DxgkDdiCreateContext deve ser tornado paginável.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Confira também

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice