DXGKDDI_RELEASESWIZZLINGRANGE función de devolución de llamada (d3dkmddi.h)

Artículo
02/06/2025

La función DxgkDdiReleaseSwizzlingRange libera un rango de DxgkDdiAcquireSwizzlingRange función configurada anteriormente.

Sintaxis

DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;

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

Parámetros

[in] hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice.

[in] pReleaseSwizzlingRange

Puntero a una estructura de DXGKARG_RELEASESWIZZLINGRANGE que contiene información para liberar el intervalo de giro.

Valor devuelto

dxgkDdiReleaseSwizzlingRange devuelve STATUS_SUCCESS o un resultado de error adecuado si el intervalo de giro no se libera correctamente.

Observaciones

Normalmente se llama a la función DxgkDdiReleaseSwizzlingRange cuando se llama a la asignación especificada (es decir, el hAllocation miembro de la estructura de DXGKARG_RELEASESWIZZLINGRANGE a la que apunta el parámetro pReleaseSwizzlingRange) o cuando otra asignación requiere el intervalo de rotación al que especifica el RangeId miembro de DXGKARG_RELEASESWIZZLINGRANGE.

Si la asignación especificada está asociada actualmente a varios intervalos de giro (a través de llamadas al DxgkDdiAcquireSwizzlingRange función), el controlador de miniporte para mostrar debe liberar solo el intervalo de giro que especifica el RangeId miembro de DXGKARG_RELEASESWIZZLINGRANGE. Si el controlador de minipuerto de pantalla libera todos los intervalos de giro asociados a la asignación, los daños aleatorios en la asignación pueden dar lugar a que una aplicación esté usando actualmente uno o varios de los intervalos de giro.

El controlador debe usar la E/S asignada por memoria (MMIO) para configurar un intervalo de giro. Estos accesos de intervalo de giro no deben interferir con la ejecución de la GPU (es decir, la GPU no debe estar inactiva cuando se llama a DxgkDdiReleaseSwizzlingRange).

Todas las llamadas a dxgkDdiReleaseSwizzlingRange se serializan entre sí, pero no con ninguna otra función de interfaz de controlador de dispositivo (DDI).

dxgkDdiReleaseSwizzlingRange debe ser paginable.