DXGKDDI_CREATEOVERLAY função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiCreateOverlay habilitará o hardware de sobreposição se o hardware for capaz.
Sintaxe
DXGKDDI_CREATEOVERLAY DxgkddiCreateoverlay;
NTSTATUS DxgkddiCreateoverlay(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_CREATEOVERLAY pCreateOverlay
)
{...}
Parâmetros
[in] hAdapter
Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporta de exibição anteriormente forneceu esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .
[in/out] pCreateOverlay
Um ponteiro para uma estrutura DXGKARG_CREATEOVERLAY que descreve a sobreposição.
Retornar valor
DxgkDdiCreateOverlay retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateOverlay criou com êxito a sobreposição. |
| STATUS_INVALID_PARAMETER | Os parâmetros passados para DxgkDdiCreateOverlay continham erros que impediam a conclusão. |
| STATUS_NO_MEMORY | DxgkDdiCreateOverlay não pôde alocar a memória necessária para que ela fosse concluída. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiCreateOverlay não pôde ser concluído porque a largura de banda insuficiente estava disponível ou o hardware de sobreposição solicitado não pôde concluir a tarefa. |
| 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 DxgkDdiCreateOverlay. |
Comentários
DxgkDdiCreateOverlay 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 (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |