Função D3DKMTSetAllocationPriority (d3dkmthk.h)

Artigo
02/06/2025

A função D3DKMTSetAllocationPriority define o nível de prioridade de um recurso ou lista de alocações.

Sintaxe

NTSTATUS D3DKMTSetAllocationPriority(
  [in] const D3DKMT_SETALLOCATIONPRIORITY *unnamedParam1
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura de D3DKMT_SETALLOCATIONPRIORITY que contém informações para definir o nível de prioridade de um recurso ou lista de alocações.

Valor de retorno

D3DKMTSetAllocationPriority retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O nível de prioridade para alocações foi definido com êxito.
STATUS_DEVICE_REMOVED	O adaptador gráfico foi interrompido ou o dispositivo de exibição foi redefinido.
STATUS_INVALID_PARAMETER	Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores de NTSTATUS.

Observações

O exemplo de código a seguir demonstra como um ICD OpenGL pode usar D3DKMTSetAllocationPriority para definir o nível de prioridade de um recurso (e, portanto, todas as alocações associadas ao recurso).

VOID SetResourcePriority(D3DKMT_HANDLE hDevice, D3DKMT_HANDLE hResource, UINT uiPriority)
{
    D3DKMT_SETALLOCATIONPRIORITY SetAllocationPriorityData;

    SetAllocationPriorityData.hDevice = hDevice;
    SetAllocationPriorityData.hResource = hResource;
    SetAllocationPriorityData.phAllocationList = NULL;
    SetAllocationPriorityData.AllocationCount = 0;
    SetAllocationPriorityData.Priorities = &uiPriority;

    (*pfnKTSetAllocationPriority)(&SetAllocationPriorityData);
}

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Universal
cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

D3DKMT_SETALLOCATIONPRIORITY

Partilhar via