DXGKDDI_QUERYDIRTYBITDATA fonction de rappel (d3dkmddi.h)
Dxgkrnl appelle DxgkDdiQueryDirtyBitData pour demander une copie des données de plan de bits sale à partir du pilote de miniport d’affichage en mode noyau (KMD).
Syntaxe
DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;
NTSTATUS DxgkddiQuerydirtybitdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}
Paramètres
hAdapter
[in] Handle vers un bloc de contexte associé à un adaptateur d’affichage. KMD a précédemment fourni ce handle pour Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgiDdiAddDevice.
pArgs
[in/out] Pointeur vers une structure DXGKARG_QUERYDIRTYBITDATA qui contient des informations d’entrée et de sortie pour la requête.
Valeur de retour
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 la mémoire et les identificateurs potentiels de sous-range pour les informations incorrectes 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 essaie d’accélérer cette opération à l’aide d’un seul appel pour interroger toutes les données nécessaires en même temps. 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, ce 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 plan de bits sale demandée ne dépassera jamais une plage sale activement suivie.
Pour plus d’informations, consultez suivi des bits sales.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 24H2 (WDDM 3.2) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |