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 반환하거나 스위즐링 범위가 성공적으로 해제되지 않은 경우 적절한 오류 결과를 반환합니다.
설명
DxgkDdiReleaseSwizzlingRange 함수는 일반적으로 지정된 할당(즉, pReleaseSwizzlingRange 매개 변수가 가리키는 DXGKARG_RELEASESWIZZLINGRANGE 구조의 hAllocation 멤버)이 제거되거나 제거되거나 다른 할당에 DXGKARG_RELEASESWIZZLINGRANGE RangeId 멤버가 지정한 스위즐링 범위가 필요할 때 호출됩니다.
지정된 할당이 현재 여러 스위즐링 범위와 연결된 경우( DxgkDdiAcquireSwizzlingRange 함수 호출을 통해) 표시 미니포트 드라이버는 DXGKARG_RELEASESWIZZLINGRANGE RangeId 멤버가 지정한 스위즐링 범위만 해제해야 합니다. 디스플레이 미니포트 드라이버가 할당과 연결된 모든 스위즐링 범위를 해제하는 경우 애플리케이션이 현재 하나 이상의 스위즐링 범위를 사용하고 있을 수 있으므로 할당의 임의 손상이 발생할 수 있습니다.
드라이버는 MMIO(메모리 매핑 I/O)를 사용하여 스위즐링 범위를 설정해야 합니다. 이러한 스위즐링 범위 액세스는 GPU 실행을 방해해서는 안 됩니다(즉, DxgkDdiReleaseSwizzlingRange 가 호출될 때 GPU는 유휴 상태여야 함).
DxgkDdiReleaseSwizzlingRange에 대한 모든 호출은 자체적으로 직렬화되지만 다른 DDI(디바이스 드라이버 인터페이스) 함수에서는 직렬화되지 않습니다.
DxgkDdiReleaseSwizzlingRange 를 페이징 가능으로 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |