DXGKDDI_CREATEDEVICE função de retorno de chamada (d3dkmddi.h)
A função DXGKDDI_CREATEDEVICE cria um dispositivo de contexto gráfico que é posteriormente usado 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çãoDxgiDdiAddDevice.
pCreateDevice
[entrada/saída] Ponteiro para uma estrutura DXGKARG_CREATEDEVICE que descreve o dispositivo de contexto gráfico.
Valor de retorno
DXGKDDI_CREATEDEVICE retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE criado com êxito o dispositivo de contexto gráfico. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE não foi possível alocar a memória necessária para que ela fosse concluída. |
Observações
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).
Nota
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 |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |