DXGKARG_CONNECTDOORBELL Struktur (d3dkmddi.h)

Artikel
02/06/2025

Wichtig

Einige Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Veröffentlichung erheblich geändert werden kann. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.

Die DXGKARG_CONNECTDOORBELL Struktur enthält Parameter für DxgkDdiConnectDoorbell.

Syntax

typedef struct _DXGKARG_CONNECTDOORBELL {
  HANDLE                        hDoorbell;
  DXGKARG_CONNECTDOORBELL_FLAGS Flags;
  void                          *KernelCpuVirtualAddress;
  void                          *SecondaryKernelCpuVirtualAddress;
  D3DDDI_DOORBELLSTATUS         Status;
} DXGKARG_CONNECTDOORBELL;

Angehörige

hDoorbell

[in] KMD-Griff zum Doorbell-Objekt, das zuvor mit DxgkDdiCreateDoorbellerstellt wurde.

Flags

[in] Ein Bitfeld mit DXGKARG_CONNECTDOORBELL_FLAGS Werten, die die Türbellverbindungsflaggen angeben. Wenn UMD diese Türglocke mit der RequireSecondaryCpuVA Flag erstellt hat, legt Dxgkrnl die RequireSecondaryAddress Flag in diesem DDI fest, um KMD darüber zu informieren, dass diese Türbell zwei physische Adressen benötigt.

KernelCpuVirtualAddress

[out] Die virtuelle CPU-Adresse im Kernelmodus ist der physischen Adresse zugeordnet, die KMD dieser Türglocke zuweisen möchte. Dxgkrnl- wird diese Adresse einer virtuellen CPU-Adresse des Prozessadressraums zuordnen, die der UMD in D3DKMTCreateDoorbellbereitgestellt wurde. UMD schreibt einen bestimmten Wert für diese Adresse und "klingelt die Türglocke", um den GPU-Scheduler über eine neue Arbeitsübermittlung an hHwQueuezu benachrichtigen.

SecondaryKernelCpuVirtualAddress

[out/optional] Die virtuelle CPU-Adresse im Kernelmodus ist der sekundären physischen Adresse zugeordnet, die KMD dieser Türglocke zuweisen möchte, falls erforderlich.

Status

[out] Ein D3DDDI_DOORBELLSTATUS Wert, auf den KMD Dxgkrnl in die UMD-sichtbare Seite schreiben möchte, auf die pDoorbellStatusCpuVirtualAddress verweist. Dieser Wert kann nur D3DDDI_DOORBELL_STATUS_CONNECTED oder D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY werden.