DXGKARGCB_CREATECONTEXTALLOCATION Struktur (d3dkmddi.h)

Die DXGKARGCB_CREATECONTEXTALLOCATION-Struktur enthält die Zuordnungsattribute eines GPU- oder gerätespezifischen Kontexts, der in der DXGKCB_CREATECONTEXTALLOCATION Rückruffunktion verwendet wird.

Syntax

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Member

[in] ContextAllocationFlags

Eine DXGK_CREATECONTEXTALLOCATIONFLAGS-Struktur , die die Eigenschaften der Zuordnung angibt.

[in] hAdapter

Ein Handle für den Grafikkarten, für den die Kontextzuordnung erstellt wird.

[in] hDevice

Ein Handle für das Anzeigegerät, das ursprünglich vom DirectX-Grafiksubsystem an die DxgkDdiCreateDevice-Funktion des Anzeigeminiporttreibers übergeben wurde.

Hinweis

Dieser Member ist für ein Systemgerät auf NULL festgelegt.

[in] hContext

Wenn ContextAllocationFlags.SharedAcrossContexts auf den Wert 0 festgelegt ist, enthält dieses Element den Wert, der vom DirectX-Grafiksubsystem für den Kontext zugewiesen wurde, der an die DXGKCB_CREATECONTEXTALLOCATION-Funktion übergeben wurde.

Wenn ContextAllocationFlags.SharedAcrossContexts auf den Wert 1 festgelegt ist, sollte dieser Member auf NULL festgelegt werden.

Hinweis

Dieser Member ist auch für einen Systemkontext auf NULL festgelegt.

[in] hDriverAllocation

Ein vom Anzeigeminiporttreiber erstelltes Handle, das die erstellte Zuordnung identifiziert. Der Wert dieses Members wird anschließend als Transfer.hAllocation-Member der DXGKARG_BUILDPAGINGBUFFER-Struktur übergeben, auf die der pBuildPagingBuffer-Parameter der DxgkDdiBuildPagingBuffer-Funktion verweist.

[in] Size

Die Größe in Bytes, die für die Zuordnung erforderlich ist.

[in] Alignment

Die erforderliche Ausrichtung in Bytes für die Zuordnung.

[in] SupportedSegmentSet

Segmentbezeichner, die der Anzeigeminiporttreiber im PreferredSegment-Member für Lese- oder Schreibvorgänge festlegen kann.

[in] EvictionSegmentSet

Bezeichner von Segmenten, die für die Entfernung verwendet werden können.

[in] PreferredSegment

Eine DXGK_SEGMENTPREFERENCE-Struktur , die die bevorzugten Segmentbezeichner angibt, die der Anzeigeminiporttreiber anfordert, die der Videospeicher-Manager zum Einblättern der Zuordnung verwendet.

[in] HintedBank

Eine DXGK_SEGMENTBANKPREFERENCE-Struktur , die die Vom Anzeigeminiporttreiber angeforderten Bankreihenfolgeeinstellungen angibt, die der Videospeicher-Manager zum Einblättern der Zuordnung verwendet.

[in] Flags

Eine DXGK_ALLOCATIONINFOFLAGS-Struktur , die Eigenschaften für eine Zuordnung in Bitfeldflags identifiziert. Diese Eigenschaften geben den Typ der zu erstellenden Zuordnung an. Der Anzeigeminiporttreiber gibt diese Flags für den Videospeicher-Manager an. Einschränkungen für Flagwerte finden Sie unter Hinweise.

[out] hAllocation

Ein Handle, das vom DirectX-Grafiksubsystem der Zuordnung zugewiesen wurde. Dieser Wert wird anschließend als hAllocation-Parameter der DXGKCB_DESTROYCONTEXTALLOCATION-Funktion übergeben.

[in] PhysicalAdapterIndex

Der Index des physischen Adapters. Dieses Feld ist ab WDDM 2.0 verfügbar.

Hinweise

Der Display-Miniporttreiber ruft DXGKCB_CREATECONTEXTALLOCATION auf, um einen GPU- oder gerätespezifischen Kontext zuzuordnen. Wenn der Treiber diese Funktion aufruft, übergibt er über den ContextAllocation-Parameter einen Zeiger auf eine DXGKARGCB_CREATECONTEXTALLOCATION-Struktur.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 (WDDM 1.2)
Unterstützte Mindestversion (Server)	Windows Server 2012
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)

Weitere Informationen

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION