DXGKDDI_BUILDTESTCOMMANDBUFFER fonction de rappel (d3dkmddi.h)
La fonction DXGKDDI_BUILDTESTCOMMANDBUFFER kmD génère une mémoire tampon de commande de test pour test en mode noyau.
Syntaxe
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Paramètres
hAdapter
[in] Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage en mode noyau (KMD) a précédemment fourni ce handle pour Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkddiAddDevice.
pArgs
[in/out] Pointeur vers une structure DXGKARG_BUILDTESTCOMMANDBUFFER qui décrit la mémoire tampon de commande de test à générer.
Valeur de retour
DXGKDDI_BUILDTESTCOMMANDBUFFER retourne NTSTATUS_SUCCESS si la fonction réussit. Sinon, il retourne un code NTSTATUS approprié tel que STATUS_BUFFER_OVERFLOW.
Remarques
DXGKDDI_BUILDTESTCOMMANDBUFFER génère une mémoire tampon de commandes avec des instructions spécifiques à l’appareil pour un ensemble de commandes simples. KMD retourne un pointeur vers cette fonction dans pfnBuildTestCommandBuffer via DxgkDdiQueryFeatureInterface(DXGK_FEATURE_KERNEL_MODE_TESTING).
Lorsque pDmaBuffer a la valeur NULL ou est trop petit, KMD doit définir la taille requise pour la mémoire tampon dans DmaBufferSize et retourner STATUS_BUFFER_OVERFLOW.
Lorsque pDmaBufferPrivateData a la valeur NULL ou trop petite et que KMD doit générer des données privées, KMD doit définir la taille requise dans DmaBufferPrivateDataSize et retourner STATUS_BUFFER_OVERFLOW.
Le kmD doit calculer la taille des deux mémoires tampons dans le même appel.
Pour plus d’informations, consultez test en mode noyau.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 24H2 (WDDM 3.2) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |