DXGKDDI_SYSTEM_DISPLAY_WRITE 콜백 함수(dispmprt.h)

아티클
02/23/2024

디스플레이 미니포트 드라이버가 디스플레이 디바이스에 이미지 블록을 쓰도록 요청하기 위해 운영 체제에서 호출됩니다.

Windows 8 시작해서 운영 체제는 시스템 중지 오류 후 버그 검사 작업 중에 이 함수를 호출합니다. 운영 체제는 디스플레이 디바이스가 이전에 DxgkDdiSystemDisplayEnable 호출을 통해 다시 설정된 경우에만 이 함수를 호출합니다.

구문

DXGKDDI_SYSTEM_DISPLAY_WRITE DxgkddiSystemDisplayWrite;

void DxgkddiSystemDisplayWrite(
  [in] PVOID MiniportDeviceContext,
  [in] PVOID Source,
  [in] UINT SourceWidth,
  [in] UINT SourceHeight,
  [in] UINT SourceStride,
  [in] UINT PositionX,
  [in] UINT PositionY
)
{...}

매개 변수

[in] MiniportDeviceContext

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 이 핸들을 Microsoft DirectX 그래픽 커널 하위 시스템에 제공했습니다.

[in] Source

시스템 중지 오류에 대한 정보를 표시하는 버그 검사 화면에 쓸 원본 이미지의 시작 주소에 대한 포인터입니다.

[in] SourceWidth

지정된 원본 이미지의 너비(픽셀 단위)를 지정하는 UINT 값입니다.

[in] SourceHeight

지정된 원본 이미지의 높이(픽셀 단위)를 지정하는 UINT 값입니다.

[in] SourceStride

지정된 원본 이미지의 각 줄에 대한 바이트 수를 지정하는 UINT 값입니다.

[in] PositionX

디스플레이 디바이스에서 지정된 원본 이미지를 작성해야 하는 시작 X 좌표를 지정하는 UINT 값입니다.

[in] PositionY

디스플레이 디바이스에서 지정된 원본 이미지를 기록해야 하는 시작 Y 좌표를 지정하는 UINT 값입니다.

반환 값

없음

설명

원본 이미지 제한

디스플레이 미니포트 드라이버는 DxgkDdiSystemDisplayWrite 함수가 호출되는 경우 다음 지침을 따라야 합니다.

원본 이미지의 색 형식은 항상 D3DDDIFORMAT 열거형의 D3DDDIFMT_R8G8B8 (픽셀당 24비트) 또는 D3DDDIFMT_A8R8G8B8 (32bpp) 형식입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiSystemDisplayEnable 이 호출되었을 때 이 형식의 쓰기 작업을 사용하도록 표시 모드를 설정했습니다.
원본 이미지는 페이징되지 않은 메모리에 있습니다. 표시 미니포트 드라이버는 PostionX 및 PositionY 매개 변수로 지정된 위치에서 시작하여 현재 프레임 버퍼에 이 원본 이미지를 작성해야 합니다.
디스플레이 미니포트 드라이버는 CPU를 사용하여 이미지 블록을 프레임 버퍼에 써야 합니다. 시스템에서 중지 오류가 발생하면 디스플레이 디바이스에서 TDR(연속 시간 제한 검색 및 복구)으로 인해 발생했을 수 있습니다. 이 경우 GPU(그래픽 처리 장치)가 알 수 없는 상태일 수 있습니다.
TDR에 대한 자세한 내용은 TDR(시간 제한 검색 및 복구)을 참조하세요.

페이징하지 않은 메모리 사용

이 함수가 호출되는 동안에는 Windows 커널 모드 함수를 사용할 수 없을 수 있습니다.

DxgkDdiSystemDisplayWrite 는 모든 IRQL에서 호출할 수 있으므로 페이지가 없는 메모리에 있어야 합니다. DxgkDdiSystemDisplayWrite 는 페이징 가능한 메모리에 있는 코드를 호출해서는 안 되며 페이징 가능한 메모리에 있는 데이터를 조작해서는 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	데스크톱
머리글	dispmprt.h
IRQL	모든 수준(설명 섹션 참조)