DXGKDDI_SUBMITCOMMANDVIRTUAL fonction de rappel (d3dkmddi.h)
DxgkDdiSubmitCommandVirtual est utilisé pour envoyer une mémoire tampon d’accès direct à la mémoire (DMA) à un contexte qui prend en charge l’adressage virtuel.
Le pilote est chargé de s’assurer que l’espace d’adressage correct est restauré avant l’envoi d’une mémoire tampon DMA particulière.
Syntaxe
DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;
NTSTATUS DxgkddiSubmitcommandvirtual(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}
Paramètres
hAdapter
Handle d’un bloc de contexte associé à une carte d’affichage.
pSubmitCommand
Pointeur vers une structure DXGKARG_SUBMITCOMMANDVIRTUAL qui décrit l’opération.
Valeur retournée
| Valeur | Description |
|---|---|
| STATUS_SUCCESS | La commande envoyée est bien formée. |
| STATUS_INVALID_PARAMETER | Les données DMA ou privées sont jugées incorrectes. Dans ce cas, le système d’exploitation place l’appareil appelant dans un état d’erreur et tous les appels suivants échouent. La valeur SubmissionFenceId passée à cet appel sera considérée comme terminée une fois tous les paquets précédents sur le matériel terminés et à ce stade, la notion de pilote du dernier ID de clôture terminé doit être mise à jour vers cette valeur. Note: Ce comportement est différent de l’appel DxgkDdiSubmitCommand où aucune erreur n’est autorisée à être retournée en raison de la possibilité de valider les données dans un appel DxgkDdiRender précédent. |
Toutes les autres valeurs de retour entraînent la vérification des bogues du système d’exploitation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dkmddi.h |