DXGKDDI_QUERYDIRTYBITDATA fonction de rappel (d3dkmddi.h)

Dxgkrnl appelle DxgkDdiQueryDirtyBitData pour demander une copie des données du plan de bits sale à partir du pilote KMD (Display Miniport Driver) en mode noyau.

Syntaxe

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

Paramètres

hAdapter

[in] Handle d’un bloc de contexte associé à un adaptateur d’affichage. KMD a précédemment fourni ce handle à Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgiDdiAddDevice .

pArgs

[entrée/sortie] Pointeur vers une structure DXGKARG_QUERYDIRTYBITDATA qui contient des informations d’entrée et de sortie pour la requête.

Valeur retournée

DxgkDdiQueryDirtyBitData retourne STATUS_SUCCESS si la requête a réussi. Sinon, elle retourne un code d’erreur NTSTATUS approprié.

Remarques

La fonction fournit la base de mémoire et les identificateurs de sous-plage potentiels pour les informations de sale demandées. KMD doit écrire les données obtenues dans la mémoire tampon de sortie. DxgkDdiQueryDirtyBitData permet d’interroger toutes les plages de la base de mémoire ou une seule.

Lorsque la mémoire est facilement disponible, Dxgkrnl tente d’accélérer cette opération à l’aide d’un seul appel pour interroger toutes les données nécessaires à la fois. Toutefois, dans des conditions de mémoire faible, la progression vers l’avant à l’aide d’une mémoire tampon de taille fixe plus petite peut être nécessaire, qui n’est qu’un sous-ensemble plus petit de la base de mémoire suivie à partir d’un appel antérieur à DdiStartDirtyTracking. La plage de sale de plan de bits demandée ne dépassera jamais une plage de sale suivie activement.

Pour plus d’informations, consultez Suivi des bits sales.

Configuration requise

Voir aussi

DXGKARG_QUERYDIRTYBITDATA