estructura DXGKARG_OPENALLOCATION (d3dkmddi.h)

Artículo
02/06/2025

La estructura DXGKARG_OPENALLOCATION describe las asignaciones que debe abrir el controlador de minipuerto de pantalla.

Sintaxis

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Miembros

[in] NumAllocations

Número de elementos de la matriz que especifica el miembro pOpenAllocation, que representa el número de asignaciones específicas del dispositivo que se van a abrir.

[in/out] pOpenAllocation

Matriz de estructuras de DXGK_OPENALLOCATIONINFO para que se abran las asignaciones.

[in] pPrivateDriverData

Puntero a un bloque de datos privados que se pasa desde el controlador de pantalla en modo de usuario al controlador de minipuerto de pantalla. Este bloque de datos privados es el mismo dato específico del recurso que se pasa en la pPrivateDriverData miembro de la estructura DXGKARG_CREATEALLOCATION de la llamada a la función DxgkDdiCreateAllocation. El controlador de minipuerto de pantalla no puede modificar este bloque de datos privados.

[in] PrivateDriverSize

Tamaño, en bytes, del bloque de datos privados al que pPrivateDriverData apunta.

[in] Flags

Estructura DXGK_OPENALLOCATIONFLAGS que identifica la operación que se va a realizar para las asignaciones.

[in] SubresourceIndex

Se admite a partir de Windows 8.

Índice en el recurso para la superficie de destino de representación.

El sistema operativo especifica este miembro solo si el controlador de miniporte de pantalla admite aceleración de hardware GDI. En concreto, el controlador de minipuerto de pantalla debe implementar la función DxgkDdiRenderKm y debe crear el dispositivo con el miembro GdiDevice establecido en DXGKARG_CREATEDEVICE.Marcas.

Si el valor de subresourceIndex es mayor que el número de subrecursos de la asignación, el controlador de miniport para mostrar debe devolver un error.

[out] SubresourceOffset

Se admite a partir de Windows 8.

Desplazamiento, en bytes, desde el principio de la asignación hasta el inicio del subrecurso.

[out] Pitch

Se admite a partir de Windows 8.

El tono, en bytes, de la asignación, es decir, la distancia, en bytes, al inicio de la fila siguiente.