다음을 통해 공유


NtGdiDdUnattachSurface 함수

[이 함수는 각 운영 체제 수정 버전에 따라 변경될 수 있습니다. 대신 Microsoft DirectDraw 및 Microsoft Direct3DAPIs를 사용합니다. 이러한 API는 이러한 운영 체제 변경으로부터 애플리케이션을 격리하고 디스플레이 드라이버와 직접 상호 작용하는 데 관련된 다른 많은 어려움을 숨깁니다.]

두 커널 모드 표면 개체 간에 NtGdiDdAttachSurface로 만든 첨부 파일을 제거합니다.

구문

VOID APIENTRY NtGdiDdUnattachSurface(
  _In_ HANDLE hSurface,
  _In_ HANDLE hSurfaceAttached
);

매개 변수

hSurface [in]

hSurfaceFrom 매개 변수로 NtGdiDdAttachSurface로 전달된 커널 모드 표면 개체입니다.

hSurfaceAttached [in]

hSurfaceTo 매개 변수로 NtGdiDdAttachSurface에 전달된 커널 모드 표면 개체입니다.

반환 값

NtGdiDdUnattachSurface 는 다음 콜백 코드 중 하나를 반환합니다.

반환 코드 설명
DDHAL_DRIVER_HANDLED
드라이버가 작업을 수행하고 해당 작업에 유효한 반환 코드를 반환했습니다. 이 코드가 DD_OK 경우 DirectDraw 또는 Direct3D는 함수를 계속 진행합니다. 그렇지 않으면 DirectDraw 또는 Direct3D는 드라이버에서 제공하는 오류 코드를 반환하고 함수를 중단합니다.
DDHAL_DRIVER_NOTHANDLED
드라이버에 요청된 작업에 대한 주석이 없습니다. 드라이버가 특정 콜백을 구현해야 하는 경우 DirectDraw 또는 Direct3D는 오류 조건을 보고합니다. 그렇지 않으면 DirectDraw 또는 Direct3D는 DirectDraw 또는 Direct3D 디바이스 독립적 구현을 실행하여 드라이버 콜백이 정의되지 않은 것처럼 작업을 처리합니다.

 

설명

애플리케이션은 더 높은 수준의 방식으로 표면 첨부 파일을 처리하는 DirectDraw API를 사용하는 것이 좋습니다.

NtGdiDdDestroySurface가 호출될 때 커널이 모든 첨부 파일을 자동으로 삭제하므로 이 함수를 호출할 필요가 없습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
Windows 2000 Server[데스크톱 앱만]
헤더
Ntgdi.h

추가 정보

그래픽 하위 수준 클라이언트 지원