DXGKDDI_RELEASESWIZZLINGRANGE回呼函式 (d3dkmddi.h)

DxgkDdiReleaseSwizzlingRange 函式會釋放 DxgkDdiAcquireSwizzlingRange 函式先前設定的撥合範圍。

語法

DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;

NTSTATUS DxgkddiReleaseswizzlingrange(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 Microsoft DirectX 圖形核心子系統。

[in] pReleaseSwizzlingRange

DXGKARG_RELEASESWIZZLINGRANGE 結構的指標，其中包含釋放撥動範圍的資訊。

傳回值

DxgkDdiReleaseSwizzlingRange 會傳回STATUS_SUCCESS;如果未成功釋放 Swizzling 範圍，則傳回適當的錯誤結果。

備註

當指定的配置 (時，通常會呼叫 DxgkDdiReleaseSwizzlingRange 函式，也就是 pReleaseSwizzlingRange 參數指向 DXGKARG_RELEASESWIZZLINGRANGE) 的 hAllocation 成員，或是當另一個配置需要DXGKARG_RELEASESWIZZLINGRANGE指定之 RangeId 成員的撥動範圍時呼叫。

如果指定的配置目前與多個撥動範圍相關聯， (透過呼叫 DxgkDdiAcquireSwizzlingRange 函式) ，則顯示迷你埠驅動程式應該只釋放DXGKARG_RELEASESWIZZLINGRANGE指定 RangeId 成員的撥動範圍。 如果顯示迷你埠驅動程序釋放與配置相關聯的所有撥動範圍，則配置中的隨機損毀可能會導致，因為應用程式目前可能會使用一或多個撥動範圍。

驅動程式必須使用記憶體對應 I/O (MMIO) 來設定撥動範圍。 這些撥動範圍存取不得干擾 GPU (的執行，也就是說，當) 呼叫 dxgkDdiReleaseSwizzlingRange 時，GPU 不得閑置。

所有對 DxgkDdiReleaseSwizzlingRange 的呼叫都會自行串行化，但不會與任何其他設備驅動器介面 (DDI) 函式一起串行化。

DxgkDdiReleaseSwizzlingRange 應設為可分頁。

規格需求

另請參閱

DXGKARG_RELEASESWIZZLINGRANGE

DxgkDdiAcquireSwizzlingRange

DxgkDdiAddDevice