DXGKARG_ACQUIRESWIZZLINGRANGE-Struktur (d3dkmddi.h)

Die DXGKARG_ACQUIRESWIZZLINGRANGE-Struktur beschreibt Parameter, um eine Zuordnung über eine CPU-Blende zugänglich zu machen.

Syntax

typedef struct _DXGKARG_ACQUIRESWIZZLINGRANGE {
  [in]     HANDLE           hAllocation;
  [in]     UINT             PrivateDriverData;
  [in]     UINT             RangeId;
  [in]     UINT             SegmentId;
  [in]     SIZE_T           RangeSize;
  [in/out] PHYSICAL_ADDRESS CPUTranslatedAddress;
} DXGKARG_ACQUIRESWIZZLINGRANGE;

Member

[in] hAllocation

Ein Handle für die Zuordnung, die vom Anzeigeminiporttreiber zugewiesen wurde und das über die DxgkDdiCreateAllocation-Funktion zurückgegeben wird.

[in] PrivateDriverData

Ein UINT-Wert privater Daten, den der Benutzermodusanzeigetreiber sendet, wenn er die PfnLockCb-Funktion der Microsoft Direct3D-Runtime aufruft. Bei den privaten Daten sollte es sich um einen Index handeln, mit dem der Anzeige-Miniporttreiber den barrierefreien Teil der Zuordnung (z. B. die MIP-Ebene) bestimmen kann. Dieser Member sollte keinen Zeiger enthalten.

[in] RangeId

Der nullbasierte Bezeichner des Swizzlingbereichs, den die DxgkDdiAcquireSwizzlingRange-Funktion programmiert.

[in] SegmentId

Der Bezeichner eines Segments, in dem die Zuordnung derzeit ausgelagert wird.

[in] RangeSize

Die Größe des zu beschaffenden Bereichs in Bytes. Diese Bereichsgröße ist identisch mit der Größe der Zuordnung, für die DxgkDdiAcquireSwizzlingRange einen Bereich abruft. Der Treiber kann den Wert in RangeSize ändern, wenn das UseAlternateVA-Bitfeldflag im Flags-Member der D3DDDICB_LOCKFLAGS-Struktur in einem Aufruf der pfnLockCb-Funktion angegeben wird. Wenn das Flag UseAlternateVA nicht angegeben ist, kann der Treiber RangeSize nicht ändern.

[in/out] CPUTranslatedAddress

Die physische Basisadresse, an der die CPU die Zuordnung zuordnen soll. Der Anzeige-Miniporttreiber muss diese Informationen festlegen, wenn ein Aufruf der DxgkDdiAcquireSwizzlingRange-Funktion erfolgreich ist.

Anforderungen

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

Weitere Informationen

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

DxgkDdiCreateAllocation

pfnLockCb