DXGKDDI_CREATEDEVICE função de retorno de chamada (d3dkmddi.h)
A função DXGKDDI_CREATEDEVICE cria um dispositivo de contexto gráfico que é usado posteriormente em chamadas para as funções específicas do dispositivo do driver de miniporto de exibição.
Sintaxe
DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;
NTSTATUS DxgkddiCreatedevice(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}
Parâmetros
hAdapter
[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DxgiDdiAddDevice .
pCreateDevice
[entrada/saída] Ponteiro para uma estrutura DXGKARG_CREATEDEVICE que descreve o dispositivo de contexto gráfico.
Retornar valor
DXGKDDI_CREATEDEVICE retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE criou com êxito o dispositivo de contexto gráfico. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE não foi possível alocar memória necessária para que ela fosse concluída. |
Comentários
Dxgkrnl chama a função DXGKDDI_CREATEDEVICE do driver de miniporto de exibição para criar um dispositivo de contexto gráfico que o subsistema gráfico passa posteriormente em chamadas para o driver de miniporto de exibição. O driver usa um dispositivo para manter uma coleção de estado de renderização. O subsistema gráfico pode criar vários dispositivos no mesmo processo em um determinado adaptador de GPU (unidade de processamento gráfico).
Observação
O número de dispositivos que podem existir simultaneamente é limitado apenas pela memória do sistema disponível. Ou seja, um driver não pode ter um limite máximo de dispositivo codificado.
Em geral, os dispositivos são independentes uns dos outros; em outras palavras, os recursos criados em um dispositivo não podem ser referenciados ou acessados por recursos criados em outro dispositivo. No entanto, os recursos entre processos são uma exceção a essa regra.
DXGKDDI_CREATEDEVICE 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 |