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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11, version 24H2 (WDDM 3.2) |
| En-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |