DXGKARG_CONNECTDOORBELL Struktur (d3dkmddi.h)

Artikel
05/23/2024

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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;

Member

hDoorbell

[in] KMD-Handle für das Türklingelobjekt, das zuvor mit DxgkDdiCreateDoorbell erstellt wurde.

Flags

[in] Ein Bitfeld mit DXGKARG_CONNECTDOORBELL_FLAGS Werten, die die Türklingelverbindungsflags angeben. Wenn UMD diese Türklingel mit dem Flag RequireSecondaryCpuVA erstellt hat, legt Dxgkrnl das Flag RequireSecondaryAddress in diesem DDI fest, um KMD zu informieren, dass diese Türklingel zwei physische Adressen erfordert.

KernelCpuVirtualAddress

[out] Virtuelle CPU-Adresse im Kernelmodus, die der physischen Adresse zugeordnet ist, die KMD dieser Klingel zuweisen möchte. Dxgkrnl zuordnen diese Adresse einer virtuellen CPU-Adresse des Prozessadressraums, die dem UMD in D3DKMTCreateDoorbell bereitgestellt wurde. UMD schreibt einen bestimmten Wert an diese Adresse und "klingelt effektiv", um den GPU-Planer über eine neue Arbeitsübermittlung in hHwQueue zu benachrichtigen.

SecondaryKernelCpuVirtualAddress

[out/optional] Virtuelle CPU-Adresse im Kernelmodus, die der sekundären physischen Adresse zugeordnet ist, die KMD dieser Türklingel bei Bedarf zuweisen möchte.

Status

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