Compartilhar via


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

Confira também

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE