DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES función de devolución de llamada (d3dkmddi.h)

Configure o modifique las propiedades de programación de un contexto de dispositivo.

Sintaxis

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

NTSTATUS DxgkddiSetcontextschedulingproperties(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETCONTEXTSCHEDULINGPROPERTIES pSetContextSchedulingProperties
)
{...}

Parámetros

hAdapter

Identificador del contexto del dispositivo.

pSetContextSchedulingProperties

Puntero a una estructura de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES que contiene las propiedades de programación.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error de valores NTSTATUS adecuado.

Comentarios

Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES y, a continuación, llamando a DxgkDdiSetContextSchedulingProperties.

Cuando un adaptador se abre por primera vez para un proceso determinado, el sistema operativo llama a DxgkDdiCreateProcess para que el controlador del modo kernel (KMD) pueda crear un adecuado por proceso, por estructura de datos de seguimiento del adaptador. Cuando se crea un contexto, el KMD sabe para qué dispositivo y adaptador se crea y debe poder buscar el identificador del proceso de KMD desde la estructura de datos de seguimiento del adaptador para este proceso. Dentro del proceso de KMD, se espera que el programador tenga estructuras de datos de seguimiento para los cuatro posibles contextos de bandas de prioridad a los que se deben asignar.

Cuando se crea un contexto o cambia la prioridad de un dispositivo Direct3D, o una aplicación obtiene o pierde el foco, el sistema operativo llama al programador de GPU para configurar o modificar sus propiedades de programación. En el caso de los contextos recién creados, el sistema operativo garantiza que las propiedades de programación de contexto se establecerán antes del primer envío a este contexto. Esta llamada se puede realizar en medio de una ejecución de contexto. El programador de GPU tiene cierto margen en cuanto a cómo afecta al período de programación actual y el requisito del sistema operativo es que el cambio debe surtir efecto en la siguiente iteración de programación para la banda de prioridad.

Requisitos

Requisito	Valor
Header	d3dkmddi.h