DXGKARG_SUBMITCOMMANDVIRTUAL Struktur (d3dkmddi.h)

Artikel
02/23/2024

DXGKARG_SUBMITCOMMANDVIRTUAL wird verwendet, um einen DMA-Puffer (Direct Memory Access) an einen Kontext zu übermitteln, der die virtuelle Adressierung mit der DxgkDdiSubmitCommandVirtualDevice Driver Interface (DDI) unterstützt.

Syntax

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

Member

hContext

Das von DxgkDdiCreateContext zurückgegebene Handle.

DmaBufferVirtualAddress

Die virtuelle Adresse für den DMA-Puffer im Kontext des Übermittlungsprozesses.

DmaBufferSize

Die Größe des DMA-Puffers in Bytes.

pDmaBufferPrivateData

Ein Zeiger auf den privaten Treiberdatenpuffer.

DmaBufferPrivateDataSize

Die Größe des treiberprivaten Datenpuffers in Byte.

DmaBufferUmdPrivateDataSize

Größe der privaten Treiberdaten in Bytes, die vom Benutzermodustreiber in SubmitCommandCb festgelegt wurden. Wenn SubmitCommandCb aufgerufen wird, ordnet der DirectX-Grafikkern einen Puffer für die privaten Treiberdaten zu, deren Größe DXGK_CONTEXTINFO::DmaBufferPrivateDataSize entspricht. Diese Größe wurde vom Kernelmodustreiber im DxgkDdiCreateContext-Aufruf gemeldet. Der DirectX-Grafikkern kopiert die privaten Treiberdaten aus submitCommandCb in den zugeordneten Puffer.

SubmissionFenceId

Ein eindeutiger Bezeichner, den der Treiber in den Fence-Befehl im Ringpuffer schreiben kann. Dabei handelt es sich um den Puffer, in dem DMA-Puffer für die Ausführung der GPU in die Warteschlange eingereiht werden. Weitere Informationen zu diesen Typen von Bezeichnern finden Sie unter Bereitstellen von Zaunbezeichnern.

VidPnSourceId

Die nullbasierte Identifikationsnummer der Videoquelle, die in einem Pfad einer VidPN-Topologie (Video Present Network) für einen Flip-Vorgang vorhanden ist. Dieser Member ist nur gültig, wenn das Flip - oder FlipWithNoWait-Bitfeldflag im Flags-Element festgelegt ist.

FlipInterval

Ein D3DDDI_FLIPINTERVAL_TYPE typisierter Wert, der das Flipintervall angibt (d. a. wenn der Flip nach 0, 1, zwei, drei oder vier vertikalen Synchronisierungen auftritt). FlipInterval ist nur gültig, wenn das Flip-Bitfeldflag (d. h. TRUE) im Flags-Element festgelegt ist.

Flags

Eine DXGK_SUBMITCOMMANDFLAGS Struktur, die Informationen zum zu übermittelnden DMA-Puffer identifiziert.

EngineOrdinal

Für die zukünftige Verwendung reserviert.

NodeOrdinal

Der nullbasierte Index des Knotens, für den der Kontext erstellt wird. Identifiziert den Knoten, wenn der Kontext NULL ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)

Weitere Informationen

D3DDDI_FLIPINTERVAL_TYPE

DXGK_CONTEXTINFO

DxgkDdiCreateContext

DxgkDdiSubmitCommandVirtual

Bereitstellen von Zaunbezeichnern

Freigeben über