structure D3DKMT_CREATECONTEXT (d3dkmthk.h)

Article
10/23/2024

La structure D3DKMT_CREATECONTEXT est utilisée avec D3DKMTCreateContext pour créer un contexte d’appareil en mode noyau.

Syntaxe

typedef struct _D3DKMT_CREATECONTEXT {
  D3DKMT_HANDLE             hDevice;
  UINT                      NodeOrdinal;
  UINT                      EngineAffinity;
  D3DDDI_CREATECONTEXTFLAGS Flags;
  VOID                      *pPrivateDriverData;
  UINT                      PrivateDriverDataSize;
  D3DKMT_CLIENTHINT         ClientHint;
  D3DKMT_HANDLE             hContext;
  VOID                      *pCommandBuffer;
  UINT                      CommandBufferSize;
  D3DDDI_ALLOCATIONLIST     *pAllocationList;
  UINT                      AllocationListSize;
  D3DDDI_PATCHLOCATIONLIST  *pPatchLocationList;
  UINT                      PatchLocationListSize;
  D3DGPU_VIRTUAL_ADDRESS    CommandBuffer;
} D3DKMT_CREATECONTEXT;

Membres

hDevice

[in] Handle de l’appareil propriétaire du contexte créé.

NodeOrdinal

[in] Index de base zéro du nœud sur lequel le contexte est planifié.

EngineAffinity

[in] Index de base zéro pour le moteur, dans le nœud dans lequel NodeOrdinal spécifie, que le contexte peut s’exécuter.

Flags

[in] Structure D3DDDI_CREATECONTEXTFLAGS qui indique, dans les indicateurs de champ binaire, comment créer le contexte.

pPrivateDriverData

[in] Pointeur vers des données privées qui doivent être transmises au pilote miniport d’affichage.

PrivateDriverDataSize

[in] La taille, en octets, des données privées vers pPrivateDriverData pointe vers.

ClientHint

[in] Valeur D3DKMT_CLIENTHINT qui indique le type de client qui crée le contexte.

hContext

[out] Handle vers le contexte de l’appareil créé.

pCommandBuffer

[out] Pointeur vers un tableau de mémoires tampons de commande allouées dans lequel l’ICD OpenGL peut placer des commandes.

CommandBufferSize

[out] Taille, en octets, du bloc de mémoire vers lequel pCommandBuffer pointe vers.

pAllocationList

[out] Pointeur vers un tableau de structures D3DDDI_ALLOCATIONLIST dans laquelle l’ICD OpenGL peut insérer des allocations référencées.

AllocationListSize

[out] Nombre d’éléments dans le tableau d’allocations vers lequel pAllocationList pointe. Cette quantité d’allocations est disponible lorsque Dxgkrnl envoie la mémoire tampon de commande pointée par pCommandBuffer au pilote miniport d’affichage.

pPatchLocationList

[out] Pointeur vers un tableau alloué de structures D3DDDI_PATCHLOCATIONLIST dans laquelle l’ICD OpenGL insère des informations de mise à jour corrective.

PatchLocationListSize

[out] Nombre d’éléments dans la liste d’emplacements des correctifs vers utilisant pPatchLocationList pointe vers. Cette quantité d’emplacements de correctifs est disponible lorsque Dxgkrnl envoie la mémoire tampon de commande pointée par pCommandBuffer au pilote de miniport d’affichage.

CommandBuffer

[out] Adresse virtuelle GPU de la mémoire tampon de commande.