DXGKDDI_UPDATEOVERLAY função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiUpdateOverlay modifica o hardware de sobreposição.
Sintaxe
DXGKDDI_UPDATEOVERLAY DxgkddiUpdateoverlay;
NTSTATUS DxgkddiUpdateoverlay(
[in] IN_CONST_HANDLE hOverlay,
[in] IN_CONST_PDXGKARG_UPDATEOVERLAY pUpdateOverlay
)
{...}
Parâmetros
[in] hOverlay
Um identificador para a sobreposição a ser modificada. A função DxgkDdiCreateOverlay do driver de miniport de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX no hOverlay membro da estrutura DXGKARG_CREATEOVERLAY que pCreateOverlay aponta.
[in] pUpdateOverlay
Um ponteiro para uma estrutura de DXGKARG_UPDATEOVERLAY que descreve como modificar o hardware de sobreposição.
Valor de retorno
DxgkDdiUpdateOverlay retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | DxgkDdiUpdateOverlay modificou com êxito a sobreposição. |
| STATUS_INVALID_PARAMETER | Os parâmetros passados para DxgkDdiUpdateOverlay continham erros que o impediam de concluir. |
| STATUS_NO_MEMORY | DxgkDdiUpdateOverlay não pôde alocar memória necessária para que ela fosse concluída. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiUpdateOverlay 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 DxgkDdiUpdateOverlay. |
Observações
DxgkDdiUpdateOverlay 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 |
| IRQL | PASSIVE_LEVEL |