DXGKDDI_SUBMITCOMMAND fonction de rappel (d3dkmddi.h)

  • Article

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

Voir aussi

DXGKARG_SUBMITCOMMAND

DxgkDdiAddDevice