DXGKDDI_SUBMITCOMMAND fonction de rappel (d3dkmddi.h)
La fonction DxgkDdiSubmitCommand envoie une mémoire tampon d’accès direct à la mémoire (DMA) à l’unité d’exécution de commande matérielle.
Syntaxe
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
Paramètres
[in] hAdapter
Handle d’un bloc de contexte associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée au sous-système du noyau graphique Microsoft DirectX dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .
[in] pSubmitCommand
Pointeur vers une structure de DXGKARG_SUBMITCOMMAND qui décrit la mémoire tampon DMA que le pilote miniport d’affichage envoie à l’unité d’exécution de commande matérielle.
Valeur retournée
DxgkDdiSubmitCommand retourne STATUS_SUCCESS une fois l’exécution réussie. Si le pilote retourne à la place un code d’erreur, le système d’exploitation provoque une vérification de bogue système. Consultez la section Notes.
Remarques
Étant donné que les opérations de pagination sont considérées comme des opérations système, elles ne sont pas associées à un contexte d’application ou à un contexte graphique spécifique. Par conséquent, lorsque l’envoi est destiné à une opération de pagination, la fonction DxgkDdiSubmitCommand est appelée avec la valeur NULL spécifiée dans le membre hDevice de la structure DXGKARG_SUBMITCOMMAND vers laquelle pointe le paramètre pSubmitCommand .
Toutefois, si l’architecture d’un matériel et d’un pilote particuliers doivent avoir un appareil en interne, le pilote doit créer en interne l’appareil lors de l’initialisation de l’adaptateur et doit conserver l’appareil en interne en tant que périphérique par défaut système pour une utilisation dans les opérations de pagination.
Le pilote peut écrire la valeur fournie dans le membre SubmissionFenceId de DXGKARG_SUBMITCOMMAND dans la commande fence dans la mémoire tampon en anneau. Pour plus d’informations sur les commandes de clôture, consultez Fourniture d’identificateurs de clôture.
Si le pilote retourne un code d’erreur, le sous-système du noyau graphique DirectX entraîne une vérification de bogue système. Dans un fichier de vidage sur incident, l’erreur est notée par le message BugCheck 0x119, qui aura les quatre paramètres suivants.
- 0x2 (identifie la cause de l’erreur)
- Code d’erreur NTSTATUS retourné par l’appel de pilote ayant échoué
- Pointeur vers la structure DXGKARG_SUBMITCOMMAND
- Pointeur vers une structure de données de planificateur interne
DxgkDdiSubmitCommand doit être rendu non modifiable, car il s’exécute à IRQL = DISPATCH_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |