estrutura D3DDDICB_SETPRIORITY (d3dumddi.h)

A estrutura D3DDDICB_SETPRIORITY descreve o nível de prioridade para o qual definir um recurso ou uma lista de alocações.

Sintaxe

typedef struct _D3DDDICB_SETPRIORITY {
  [in] HANDLE              hResource;
  [in] UINT                NumAllocations;
  [in] const D3DKMT_HANDLE *HandleList;
  [in] const UINT          *pPriorities;
} D3DDDICB_SETPRIORITY;

Membros

[in] hResource

Um identificador para um recurso cuja prioridade deve ser definida. Se o driver de exibição do modo de usuário usar a matriz especificada por HandleList para definir a prioridade para a lista de alocações, ele definirá hResource como NULL. Se o driver de exibição do modo de usuário definir hResource como um valor não NULL , ele deverá definir o membro NumAllocations como zero e HandleList como NULL.

Se hResource não for NULL, todas as alocações que pertencem ao recurso serão definidas como a prioridade especificada pelo primeiro elemento na matriz para a qual pPriorities aponta.

[in] NumAllocations

O número de alocações na matriz HandleList . Se o driver de exibição do modo de usuário definir o identificador no membro hResource como um valor não NULL , ele deverá definir NumAllocations como zero.

[in] HandleList

Uma matriz de tipos de dados D3DKMT_HANDLE que representam identificadores de modo kernel para as alocações. A função pfnAllocateCb do runtime do Microsoft Direct3D retorna esses identificadores. Portanto, o driver de exibição do modo de usuário usa esses identificadores para definir a prioridade para as alocações.

Se o driver de exibição do modo de usuário definir o identificador no membro hResource como um valor não NULL , ele deverá definir HandleList como NULL.

[in] pPriorities

Um ponteiro para uma matriz de níveis de prioridade. Se o membro hResource não for NULL, a matriz deverá conter um único elemento. Se hResource for NULL, o número de elementos na matriz será especificado pelo membro NumAllocations e cada alocação na matriz especificada por HandleList será definida como o nível de prioridade do elemento correspondente em pPriorities. Para obter uma lista de níveis de prioridade definidos, consulte a seção Comentários da página de referência pfnSetPriorityCb .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Confira também

pfnAllocateCb

pfnSetPriorityCb