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 miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
[in/out] pCreateOverlay
Um ponteiro para uma estrutura DXGKARG_CREATEOVERLAY que descreve a sobreposição.
Valor de retorno
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 o impediram de concluir. |
| 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 miniporto de exibição não é compatível com o driver de exibição no modo de usuário que iniciou a chamada para DxgkDdiCreateOverlay. |
Observações
DxgkDdiCreateOverlay 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 (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |