estructura D3DDDICB_QUERYRESIDENCY (d3dumddi.h)

La estructura de 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 en el miembro HandleList para consultar la residencia, establece hResource en NULL.

Si hResource no es NULL, 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 en la matriz HandleList . Si el controlador de visualización en modo de usuario establece el identificador en el miembro hResource en distinto de NULL, debe establecer NumAllocations en cero.

[in] HandleList

Matriz de D3DKMT_HANDLE tipos de datos que representan identificadores en modo kernel a las asignaciones. La función pfnAllocateCb del entorno de ejecución de Microsoft Direct3D devuelve estos identificadores. Por lo tanto, el controlador de pantalla 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 hResource en distinto de NULL, debe establecer HandleList en NULL.

[out] pResidencyStatus

Puntero a una matriz de valores de D3DDDI_RESIDENCYSTATUS. Si el miembro hResource no es NULL, la matriz contiene un único elemento y recibe uno de los valores siguientes para indicar el estado de residencia del recurso. Si hResource es NULL, el miembro NumAllocations especifica el número de elementos de la matriz 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.

Requisitos

Consulte también

pfnQueryResidencyCb