DXGKDDI_DESCRIBEALLOCATION função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiDescribeAllocation recupera informações sobre uma alocação existente que, de outra forma, não está disponível para o subsistema de kernel de elementos gráficos do Microsoft DirectX.
Sintaxe
DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;
NTSTATUS DxgkddiDescribeallocation(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}
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 DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
[in/out] pDescribeAllocation
Um ponteiro para uma estrutura de DXGKARG_DESCRIBEALLOCATION que descreve uma alocação existente.
Valor de retorno
DxgkDdiDescribeAllocation retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
Como o subsistema de kernel de elementos gráficos DirectX não mantém necessariamente registros de alocações, o subsistema de kernel gráfico chama DxgkDdiDescribeAllocation para solicitar que o driver de miniporto de exibição retorne informações sobre alocações existentes. Atualmente, o driver de miniporto de exibição deve ser capaz de retornar essas informações para as seguintes alocações:
- Alocações que também são primárias (ou seja, alocações que o driver de exibição do modo de usuário criou definindo o sinalizador de campo de bits Primário no Flags membro da estrutura D3DDDI_ALLOCATIONINFO em uma chamada para a função pfnAllocateCb).
- Alocações que podem ser a origem de uma apresentação (ou seja, alocações representadas pelo hSource membro da estrutura DXGKARG_PRESENT em uma chamada para a função DxgkDdiPresent do driver de miniporto de exibição).
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 |