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_CREATECONTEXTALLOCATIONFLAGS