D3DKMTSubmitCommand, fonction (d3dkmthk.h)
D3DKMTSubmitCommand est utilisé pour envoyer des mémoires tampons de commande sur des contextes qui prennent en charge l’adressage virtuel de l’unité de traitement graphique (GPU). Ces contextes génèrent des commandes directement à partir du mode utilisateur, gèrent leur propre pool de mémoires tampons de commandes et n’utilisent pas la liste d’emplacements d’allocation ou de correctif.
Syntaxe
NTSTATUS D3DKMTSubmitCommand(
[in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure D3DKMT_SUBMITCOMMAND qui décrit l’opération.
Valeur de retour
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Le contexte de l’appareil a été créé avec succès. |
| STATUS_INVALID_PARAMETER | Les paramètres ont été validés et déterminés comme incorrects. |
Cette fonction peut également retourner d’autres valeurs NTSTATUS.
Remarques
Cette fonction remplace l’ancienne fonction Render pour ces contextes et doit être utilisée à sa place. Les contextes qui fonctionnent en mode correctif hérité doivent continuer à utiliser l’ancienne fonction Render.
Bien que le pilote en mode utilisateur ne génère pas d’emplacements de correctifs, il doit toujours générer une liste de primaires, qui sont écrites dans. Le gestionnaire de mémoire vidéo utilise la liste d’allocations pour déterminer quelles allocations primaires sont référencées pour l’écriture par chaque mémoire tampon de commande. Ces informations sont utilisées pour synchroniser le rendu sur les primaires avec opérations de retournement.
Certains pilotes en mode noyau ont besoin d’informations à partir de leur pilote en mode utilisateur sur la façon de soumettre une mémoire tampon DMA (Direct Memory Access) particulière à leur GPU. Dans le modèle de pilote d’affichage Windows (WDDM) 1.0, ces informations ont été envoyées par le pilote en mode utilisateur au pilote en mode noyau via la mémoire tampon de commande. Étant donné que la mémoire tampon DMA est générée directement par le pilote en mode utilisateur et envoyée au GPU sans modification, elles ne peuvent plus être utilisées pour envoyer des informations au pilote du noyau. Pour activer le transfert d’informations entre le mode utilisateur et les pilotes en mode noyau, une mémoire tampon de données de pilote privé explicite a été ajoutée pour être envoyée avec une soumission.
Note
Ces données de pilote privé sont unidirectionnelles et le pilote en mode noyau ne peut pas retourner d’informations au pilote en mode utilisateur via cette mémoire tampon.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Universel |
| d’en-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |