D3DKMT_CREATECONTEXT structure (d3dkmthk.h)

Article
10/07/2023

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 pour l’appareil qui possède le contexte en cours de création.

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 spécifié par NodeOrdinal , dans lequel 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 passées au pilote de miniport d’affichage.

PrivateDriverDataSize

[in] Taille, en octets, des données privées vers laquelle pPrivateDriverData pointe.

ClientHint

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

hContext

[out] Handle du contexte d’appareil créé.

pCommandBuffer

[out] Pointeur vers un tableau de mémoires tampons de commande allouées dans laquelle openGL ICD peut placer des commandes.

CommandBufferSize

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

pAllocationList

[out] Pointeur vers un tableau de structures D3DDDI_ALLOCATIONLIST dans laquelle openGL ICD 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 commandes pointée par pCommandBuffer au pilote de miniport d’affichage.

pPatchLocationList

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

PatchLocationListSize

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

CommandBuffer

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