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 miniport de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX no hDevice membro da estrutura DXGKARG_CREATEDEVICE.
[in/out] pCreateContext
Um ponteiro para uma estrutura DXGKARG_CREATECONTEXT que contém informações sobre como criar o contexto.
Valor de retorno
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 memória necessária para que ela fosse concluída. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | O driver de miniporto de exibição não é compatível com o driver de exibição no modo de usuário que iniciou a chamada para DxgkDdiCreateContext. |
Observações
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 tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |