estrutura D3DDDICB_QUERYRESIDENCY (d3dumddi.h)
A estrutura D3DDDICB_QUERYRESIDENCY descreve o status de residência de um recurso ou lista de alocações.
Sintaxe
typedef struct _D3DDDICB_QUERYRESIDENCY {
[in] HANDLE hResource;
[in] UINT NumAllocations;
[in] const D3DKMT_HANDLE *HandleList;
[out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;
Membros
[in] hResource
Um identificador para um recurso cuja residência é consultada. Se o driver de exibição do modo de usuário usar a matriz no membro HandleList para consultar a residência, ele definirá hResource 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. O status de residência de um recurso é igual ao status de residência mais baixo de todas as alocações que pertencem ao recurso.
[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 comoNULL não, 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 consultar a residência.
Se o driver de exibição do modo de usuário definir o identificador no membro do hResource comoNULL não, ele deverá definir HandleList para NULL.
[out] pResidencyStatus
Um ponteiro para uma matriz de valores D3DDDI_RESIDENCYSTATUS. Se o hResource membro não forNULL, a matriz conterá um único elemento e receberá um dos seguintes valores para indicar o status de residência do recurso. Se hResource for NULL, o número de elementos na matriz será especificado pelo membro NumAllocations e cada elemento receberá um dos seguintes valores para indicar o status de residência da alocação correspondente na matriz especificada por HandleList.
| Value | significado |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | O recurso ou a lista de alocações residem na memória de GPU, que é o status de residência mais alto. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | O recurso ou a lista de alocações residem na memória compartilhada. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | O recurso ou a lista de alocações não é residente, que é o status de residência mais baixo. |
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |