estrutura D3DDDICB_ALLOCATE (d3dumddi.h)

Artigo
02/23/2024

A estrutura D3DDDICB_ALLOCATE contém informações para alocar memória.

Sintaxe

typedef struct _D3DDDICB_ALLOCATE {
  [in]  const VOID            *pPrivateDriverData;
  [in]  UINT                  PrivateDriverDataSize;
  [in]  HANDLE                hResource;
  [out] D3DKMT_HANDLE         hKMResource;
  [in]  UINT                  NumAllocations;
  union {
    [in]  D3DDDI_ALLOCATIONINFO  *pAllocationInfo;
    [in]  D3DDDI_ALLOCATIONINFO2 *pAllocationInfo2;
  };
  [in]  D3DDDI_ALLOCATIONINFO *pAllocationInfo;
} D3DDDICB_ALLOCATE;

Membros

[in] pPrivateDriverData

Um ponteiro para dados privados, que é passado para o driver de miniporto de exibição. Esses dados são por recurso e não por alocação. Se as alocações estiverem anexadas a um recurso existente, os dados atuais deverão substituir os dados anteriores.

[in] PrivateDriverDataSize

O tamanho, em bytes, dos dados privados apontados por pPrivateDriverData.

[in] hResource

Um identificador para o recurso associado às alocações.

Quando o driver de exibição do modo de usuário chama a função pfnAllocateCb , o driver deve atribuir o valor que foi recebido do membro hResource da estrutura D3DDDIARG_CREATERESOURCE em uma chamada para CreateResource ou o parâmetro hRTResource em uma chamada para CreateResource(D3D10) ou CreateResource(D3D11). Ele deve atribuir o valor para associar as alocações ao recurso ou atribuir NULL para associar as alocações ao dispositivo. O driver deve atribuir um valor não NULL para alocações criadas em resposta a recursos compartilhados. Os recursos compartilhados podem resultar de chamadas CreateResource com o sinalizador de campo de bit SharedResource definido no membro Flags do D3DDDIARG_CREATERESOURCE. Eles também podem resultar de chamadas CreateResource(D3D10) ou CreateResource(D3D11), com o valor D3D10_DDI_RESOURCE_MISC_SHARED definido no membro MiscFlags de D3D10DDIARG_CREATERESOURCE ou D3D11DDIARG_CREATERESOURCE.

O runtime do Microsoft Direct3D deve usar esse identificador em chamadas de driver para identificar o recurso.

[out] hKMResource

Um tipo de dados D3DKMT_HANDLE que representa um identificador do modo kernel para o recurso associado às alocações.

O runtime do Direct3D criará e retornará um identificador de recurso do modo kernel somente se o driver de exibição do modo de usuário definir o membro hResource de D3DDDICB_ALLOCATE para o identificador de recurso de runtime do modo de usuário que foi recebido do membro hResource da estrutura D3DDDIARG_CREATERESOURCE . Esse identificador é recebido em uma chamada para CreateResource ou do parâmetro hResource em uma chamada para CreateResource(D3D10) ou CreateResource(D3D11).

O runtime do Direct3D gera um identificador exclusivo e o passa de volta para o driver de exibição do modo de usuário. O driver de exibição do modo de usuário pode inserir o identificador de recurso do modo kernel no fluxo de comandos para uso subsequente pelo driver de miniporto de exibição.

[in] NumAllocations

O número de elementos na matriz em pAllocationInfo, que representa o número de alocações a serem alocadas.

[in] pAllocationInfo

Uma matriz de estruturas de D3DDDI_ALLOCATIONINFO que descrevem as alocações a serem alocadas.

[in] Uma matriz de estruturas de D3DDDI_ALLOCATIONINFO que descrevem as alocações a serem alocadas.

[in] pAllocationInfo2

Esse membro é reservado e deve ser definido como zero.

Esse membro está disponível a partir do Windows 7.

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)