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 |