Compartilhar via

estrutura D3DKMT_QUERYALLOCATIONRESIDENCY (d3dkmthk.h)

  • Artigo

A estrutura D3DKMT_QUERYALLOCATIONRESIDENCY descreve informações para recuperar o status de residência de um recurso ou lista de alocações.

Sintaxe

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE                    hDevice;
  [in]  D3DKMT_HANDLE                    hResource;
  [in]  const D3DKMT_HANDLE              *phAllocationList;
  [in]  UINT                             AllocationCount;
  [out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} D3DKMT_QUERYALLOCATIONRESIDENCY;

Membros

[in] hDevice

Um tipo de dados D3DKMT_HANDLE que representa um identificador de modo kernel para o dispositivo ao qual o recurso ou a lista de alocações estão associados.

[in] hResource

Um identificador para um recurso cuja residência é consultada. Se o OpenGL ICD usar a matriz que phAllocationList especificar para consultar residência, ele definirá hResource para NULL. Se o ICD do OpenGL definir hResource como um valor NULL não, ele deverá definir o membro AllocationCount como zero e phAllocationList para NULL.

Se hResource não forNULL, todas as alocações que pertencem ao recurso serão consultadas e o resultado será retornado no primeiro elemento da matriz à qual pResidencyStatus aponta.

Se qualquer alocação que pertence ao recurso não for residente, todo o recurso será considerado não residente.

Para recuperar informações detalhadas de residência sobre cada alocação que pertence a um recurso, a alocação deve ser consultada.

[in] phAllocationList

Uma matriz de tipos de dados D3DKMT_HANDLE que representam identificadores de modo kernel para as alocações. O OpenGL ICD usa esses identificadores para consultar o status de residência.

Se o ICD do OpenGL definir o identificador no membro hResource como um valor NULL não, ele deverá definir phAllocationList para NULL.

[in] AllocationCount

O número de alocações na matriz que phAllocationList especifica. Se o ICD do OpenGL definir o identificador no membro hResource como um valor NULL não, ele deverá definir AllocationCount como zero.

[out] pResidencyStatus

Um ponteiro para uma matriz de enumeradores D3DKMT_ALLOCATIONRESIDENCYSTATUS. Se o hResource membro não forNULL, a matriz conterá um único elemento e receberá um dos enumeradores listados na tabela a seguir para indicar o status de residência do recurso. Se hResource for NULL, o número de elementos na matriz será especificado pelo membro AllocationCount e cada elemento receberá um dos seguintes enumeradores para indicar o status de residência da alocação correspondente na matriz phAllocationList.

Enumerador Significado
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) O recurso ou alocação reside na memória de GPU.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) O recurso ou alocação reside na memória compartilhada.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) O recurso ou alocação não é diferente.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista
cabeçalho d3dkmthk.h (inclua D3dkmthk.h)

Ver também

D3DKMTQueryAllocationResidency