estructura DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Artículo
02/23/2024

La estructura de DXGKARGCB_CREATECONTEXTALLOCATION contiene los atributos de asignación de un contexto de GPU o un contexto específico del dispositivo que se usa en la función de devolución de llamada DXGKCB_CREATECONTEXTALLOCATION .

Sintaxis

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Miembros

[in] ContextAllocationFlags

Estructura DXGK_CREATECONTEXTALLOCATIONFLAGS que especifica las propiedades de la asignación.

[in] hAdapter

Identificador del adaptador de gráficos para el que se crea la asignación de contexto.

[in] hDevice

Identificador del dispositivo de pantalla pasado originalmente por el subsistema de gráficos directX a la función DxgkDdiCreateDevice del controlador de miniporte de pantalla.

Nota

Este miembro se establece en NULL para un dispositivo del sistema.

[in] hContext

Si ContextAllocationFlags.SharedAcrossContexts se establece en un valor de 0, este miembro contiene el valor asignado por el subsistema de gráficos directX para el contexto que se pasó a la función DXGKCB_CREATECONTEXTALLOCATION .

Si ContextAllocationFlags.SharedAcrossContexts está establecido en un valor de 1, este miembro debe establecerse en NULL.

Nota

Este miembro también se establece en NULL para un contexto del sistema.

[in] hDriverAllocation

Identificador creado por el controlador de minipuerto de pantalla que identifica la asignación creada. El valor de este miembro se pasa posteriormente como miembro Transfer.hAllocation de la estructura DXGKARG_BUILDPAGINGBUFFER a la que apunta el parámetro pBuildPagingBuffer de la función DxgkDdiBuildPagingBuffer .

[in] Size

Tamaño, en bytes, necesario para la asignación.

[in] Alignment

Alineación necesaria, en bytes, para la asignación.

[in] SupportedSegmentSet

Identificadores de segmento que el controlador de miniporte de pantalla puede establecer en el miembro PreferredSegment para operaciones de lectura o escritura.

[in] EvictionSegmentSet

Identificadores de segmentos que se pueden usar para la expulsión.

[in] PreferredSegment

Estructura DXGK_SEGMENTPREFERENCE que indica los identificadores de segmento preferidos que el controlador de miniporte de pantalla solicita que el administrador de memoria de vídeo use para paginar la asignación.

[in] HintedBank

Estructura DXGK_SEGMENTBANKPREFERENCE que indica las preferencias de ordenación bancaria que el controlador de miniporte de pantalla solicita que el administrador de memoria de vídeo use para paginar la asignación.

[in] Flags

Estructura DXGK_ALLOCATIONINFOFLAGS que identifica las propiedades de una asignación en marcas de campo de bits. Estas propiedades indican el tipo de asignación que se va a crear. El controlador de minipuerto de pantalla especifica estas marcas para el administrador de memoria de vídeo. Consulte Comentarios para obtener restricciones en los valores de marca.

[out] hAllocation

Identificador asignado por el subsistema de gráficos de DirectX a la asignación. Este valor se pasa posteriormente como parámetro hAllocation de la función DXGKCB_DESTROYCONTEXTALLOCATION .

[in] PhysicalAdapterIndex

Índice del adaptador físico. Este campo está disponible a partir de WDDM 2.0.

Comentarios

El controlador de minipuerto de pantalla llama a DXGKCB_CREATECONTEXTALLOCATION para asignar un contexto de GPU o un contexto específico del dispositivo. Cuando el controlador llama a esta función, pasa un puntero a una estructura de DXGKARGCB_CREATECONTEXTALLOCATION a través del parámetro ContextAllocation .