Partager via


DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES fonction de rappel (d3dkmddi.h)

Configurez ou modifiez les propriétés de planification d’un contexte d’appareil.

Syntaxe

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

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

Paramètres

hAdapter

Handle dans le contexte de l’appareil.

pSetContextSchedulingProperties

Pointeur vers une structure DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES qui contient les propriétés de planification.

Valeur retournée

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur NTSTATUS Values approprié.

Remarques

Inscrivez votre implémentation de cette fonction de rappel en définissant le membre approprié de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES, puis en appelant DxgkDdiSetContextSchedulingProperties.

Lorsqu’un adaptateur est ouvert pour la première fois pour un processus particulier, le système d’exploitation appelle DxgkDdiCreateProcess afin que le pilote de mode noyau (KMD) puisse créer une structure de données de suivi appropriée par processus, par adaptateur. Lorsqu’un contexte est créé, le KMD sait pour quel appareil et adaptateur il est créé, et il doit être en mesure de rechercher le handle de processus KMD à partir de la structure de données de suivi de l’adaptateur pour ce processus. Dans le processus KMD, le planificateur doit avoir des structures de données de suivi pour les quatre contextes de bandes de priorité potentiels.

Lorsqu’un contexte est créé, qu’un appareil Direct3D change de priorité ou qu’une application gagne ou perd le focus, le système d’exploitation appelle le planificateur GPU pour configurer ou modifier ses propriétés de planification. Pour les contextes nouvellement créés, le système d’exploitation garantit que les propriétés de planification de contexte seront définies avant que la première soumission à ce contexte soit autorisée. Cet appel peut être effectué au milieu d’une exécution de contexte. Le planificateur GPU dispose d’une certaine marge de manœuvre quant à la façon dont il affecte la période de planification actuelle, et l’exigence du système d’exploitation est que la modification doit prendre effet sur la prochaine itération de planification pour la bande de priorité.

Configuration requise

Condition requise Valeur
En-tête d3dkmddi.h