DXGKARGCB_CREATECONTEXTALLOCATION Struktur (d3dkmddi.h)
Die DXGKARGCB_CREATECONTEXTALLOCATION-Struktur enthält die Zuordnungsattribute eines GPU-Kontexts 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;
Angehörige
[in] ContextAllocationFlags
Eine DXGK_CREATECONTEXTALLOCATIONFLAGS Struktur, die die Eigenschaften der Zuordnung angibt.
[in] hAdapter
Ein Handle für den Grafikadapter, 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 Miniporttreibers übergeben wurde.
Anmerkung
Dieses Element ist für ein Systemgerät auf NULL festgelegt.
[in] hContext
Wenn ContextAllocationFlags.SharedAcrossContexts auf einen Wert von 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 einen Wert von 1 festgelegt ist, sollte dieses Element auf NULL-festgelegt werden.
Anmerkung
Dieses Element ist auch für einen Systemkontext auf NULL festgelegt.
[in] hDriverAllocation
Ein Handle, das vom Display miniport-Treiber erstellt wurde, der die erstellte Zuordnung identifiziert. Der Wert dieses Elements wird anschließend als Transfer.hAllocation Member der DXGKARG_BUILDPAGINGBUFFER Struktur übergeben, auf das durch den pBuildPagingBuffer Parameter der DxgkDdiBuildPagingBuffer-Funktion verwiesen wird.
[in] Size
Die Größe in Byte, die für die Zuordnung erforderlich ist.
[in] Alignment
Die erforderliche Ausrichtung in Bytes für die Zuordnung.
[in] SupportedSegmentSet
Segmentbezeichner, die der Miniporttreiber für die Anzeige 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, dass der Videospeicher-Manager für die Zuordnung verwendet wird.
[in] HintedBank
Eine DXGK_SEGMENTBANKPREFERENCE Struktur, die die Bankbestellungseinstellungen angibt, die der Display-Miniport-Treiber anfordert, dass der Videospeicher-Manager für die Zuordnung verwendet wird.
[in] Flags
Eine DXGK_ALLOCATIONINFOFLAGS Struktur, die Eigenschaften für eine Zuordnung in Bitfeldkennzeichnungen identifiziert. Diese Eigenschaften geben den Typ der zu erstellenden Zuordnung an. Der Miniporttreiber für die Anzeige gibt diese Kennzeichen für den Videospeicher-Manager an. Weitere Informationen zu Kennzeichnungswerten finden Sie in den Hinweisen.
[out] hAllocation
Ein Handle, das vom DirectX-Grafiksubsystem der Zuordnung zugewiesen wurde. Dieser Wert wird anschließend als hAllocation Parameter der funktion DXGKCB_DESTROYCONTEXTALLOCATION übergeben.
[in] PhysicalAdapterIndex
Der Index des physischen Adapters. Dieses Feld ist ab WDDM 2.0 verfügbar.
Bemerkungen
Der Anzeigeminiporttreiber ruft DXGKCB_CREATECONTEXTALLOCATION auf, um einen GPU-Kontext oder gerätespezifischen Kontext zuzuweisen. Wenn der Treiber diese Funktion aufruft, übergibt er einen Zeiger an eine DXGKARGCB_CREATECONTEXTALLOCATION Struktur über den ContextAllocation Parameter.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 (WDDM 1.2) |
| mindestens unterstützte Server- | Windows Server 2012 |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
Siehe auch
DXGK_CREATECONTEXTALLOCATIONFLAGS