Compartir a través de

estructura D3DKMT_QUERYALLOCATIONRESIDENCY (d3dkmthk.h)

  • Artículo

La estructura D3DKMT_QUERYALLOCATIONRESIDENCY describe información para recuperar el estado de residencia de un recurso o una lista de asignaciones.

Sintaxis

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;

Miembros

[in] hDevice

Un D3DKMT_HANDLE tipo de datos que representa un identificador en modo kernel para el dispositivo al que están asociados el recurso o la lista de asignaciones.

[in] hResource

Identificador de un recurso cuya residencia se consulta. Si openGL ICD usa la matriz que phAllocationList especifica para consultar la residencia, establece hResource en NULL. Si openGL ICD establece hResource en un valor null que no, debe establecer el miembro AllocationCount en cero y phAllocationList 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.

Si alguna asignación que pertenece al recurso no es residente, todo el recurso se considera no residente.

Para recuperar información detallada de residencia sobre cada asignación que pertenece a un recurso, se debe consultar la asignación.

[in] phAllocationList

Matriz de D3DKMT_HANDLE tipos de datos que representan identificadores en modo kernel a las asignaciones. OpenGL ICD usa estos identificadores para consultar el estado de residencia.

Si openGL ICD establece el identificador en el miembro hResource en un valor de null que no es de, debe establecer phAllocationList en NULL.

[in] AllocationCount

Número de asignaciones de la matriz que phAllocationList especifica. Si openGL ICD establece el identificador en el hResource miembro en un valor de null que no es de, debe establecer allocationCount en cero.

[out] pResidencyStatus

Puntero a una matriz de enumeradores de D3DKMT_ALLOCATIONRESIDENCYSTATUS. Si el miembro hResource no esNULL, la matriz contiene un solo elemento y recibe uno de los enumeradores que aparecen en la tabla siguiente 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 AllocationCount y cada elemento recibe uno de los siguientes enumeradores para indicar el estado de residencia de la asignación correspondiente en la matriz phAllocationList.

Enumerador Significado
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) El recurso o la asignación residen en la memoria de GPU.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) El recurso o la asignación residen en la memoria compartida.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) El recurso o la asignación no sonidentes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
encabezado de d3dkmthk.h (incluya D3dkmthk.h)

Consulte también

D3DKMTQueryAllocationResidency