estrutura D3DDDI_ALLOCATIONLIST (d3dukmdt.h)

Artigo
02/26/2024

A estrutura D3DDDI_ALLOCATIONLIST descreve informações sobre uma especificação de alocação usada no buffer de DMA (acesso direto à memória).

Sintaxe

typedef struct _D3DDDI_ALLOCATIONLIST {
  D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation : 1;
      UINT DoNotRetireInstance : 1;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

Membros

hAllocation

[in] O identificador de alocação retornado pela função D3DKMTOpenResource no membro hAllocation da estrutura D3DDDI_OPENALLOCATIONINFO ou pela função D3DKMTCreateAllocation no membro hAllocation da estrutura D3DDDI_ALLOCATIONINFO .

WriteOperation

[in] Um UINT que pode conter informações sobre se a alocação pode ser gravada. A configuração como 1 indica que a alocação pode ser gravada.

Definir esse membro é equivalente a definir o primeiro bit do membro Value de 32 bits (0x00000001).

DoNotRetireInstance

[in] Um UINT que pode conter informações sobre se a alocação pode ser desativada. A configuração como 1 indica que o gerenciador de memória de vídeo não deve desativar a instância da alocação porque o driver fará referência a ela novamente em um buffer DMA subsequente (por exemplo, uma difusão manual de um buffer de DMA para vários contextos). Todas as instâncias de uma alocação são eventualmente desativadas. Esse sinalizador raramente é usado.

Definir esse membro é equivalente a definir o segundo bit do membro Value de 32 bits (0x00000002).

OfferPriority

[in] Um valor da enumeração D3DDDI_OFFER_PRIORITY que indica a importância dos recursos de memória de vídeo que o driver de exibição do modo de usuário oferece para reutilização.

Se OfferPriority não tiver um valor de D3DDDI_OFFER_PRIORITY_NONE, a alocação será considerada como sendo oferecida depois que o buffer de DMA for processado.

Definir esse membro é equivalente a definir bits de 3 a 5 do membro Value de 32 bits (0x0000001C).

Com suporte a partir do Windows 8.

Reserved

[in] Esse membro é reservado e deve ser definido como zero.

Value

[in] Um valor de 32 bits que identifica informações sobre uma especificação de alocação usada no buffer de DMA.