estructura D3DDDICB_QUERYRESIDENCY (d3dumddi.h)
La estructura D3DDDICB_QUERYRESIDENCY describe el estado de residencia de un recurso o una lista de asignaciones.
Sintaxis
typedef struct _D3DDDICB_QUERYRESIDENCY {
[in] HANDLE hResource;
[in] UINT NumAllocations;
[in] const D3DKMT_HANDLE *HandleList;
[out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;
Miembros
[in] hResource
Identificador de un recurso cuya residencia se consulta. Si el controlador de visualización en modo de usuario usa la matriz del miembro de HandleList para consultar la residencia, establece hResource en null.
Si hResource no esNULL, se consultan todas las asignaciones que pertenecen al recurso y el resultado se devuelve en el primer elemento de la matriz a la que apunta pResidencyStatus. El estado de residencia de un recurso es igual al estado de residencia más bajo de todas las asignaciones que pertenecen al recurso.
[in] NumAllocations
Número de asignaciones de la matriz de HandleList. Si el controlador de visualización en modo de usuario establece el identificador en el miembro hResource enNULL, debe establecer NumAllocations en cero.
[in] HandleList
Matriz de D3DKMT_HANDLE tipos de datos que representan identificadores en modo kernel a las asignaciones. El entorno de ejecución de Microsoft Direct3D función pfnAllocateCb devuelve estos identificadores. Por lo tanto, el controlador de visualización en modo de usuario usa estos identificadores para consultar la residencia.
Si el controlador de visualización en modo de usuario establece el identificador en el miembro hResourcenull, debe establecer HandleList en NULL.
[out] pResidencyStatus
Puntero a una matriz de valores de D3DDDI_RESIDENCYSTATUS. Si el miembro hResource no esNULL, la matriz contiene un solo elemento y recibe uno de los valores siguientes para indicar el estado de residencia del recurso. Si hResource es null, el número de elementos de la matriz se especifica mediante el miembro NumAllocations y cada elemento recibe uno de los siguientes valores para indicar el estado de residencia de la asignación correspondiente en la matriz especificada por HandleList.
| valor | significado |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | El recurso o la lista de asignaciones residen en la memoria de GPU, que es el estado de residencia más alto. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | El recurso o la lista de asignaciones residen en la memoria compartida. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | El recurso o la lista de asignaciones es distinto del identificador, que es el estado de residencia más bajo. |
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |