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 residência, ele definirá hResource como NULL.
Se hResource não for NULL, todas as alocações que pertencem ao recurso serão consultadas e o resultado será retornado no primeiro elemento da matriz para a qual pResidencyStatus aponta. A status de residência de um recurso é igual à status de residência mais baixa 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 como 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 consultar residência.
Se o driver de exibição do modo de usuário definir o identificador no membro hResource como não NULL, ele deverá definir HandleList como NULL.
[out] pResidencyStatus
Um ponteiro para uma matriz de valores D3DDDI_RESIDENCYSTATUS. Se o membro hResource não for NULL, a matriz conterá um único elemento e receberá um dos valores 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 NumAllocations e cada elemento receberá um dos valores a seguir para indicar o status de residência da alocação correspondente na matriz especificada por HandleList.
| Valor | Significado |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | O recurso ou a lista de alocações residem na memória de GPU, que é a status de residência mais alta. |
| 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 é a status de residência mais baixa. |
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) |