다음을 통해 공유

DCompositionCreateSurfaceHandle 함수(dcomp.h)

  • 아티클

Microsoft DirectX 스왑 체인 또는 스왑 버퍼에 바인딩되고 시각적 개체와 연결할 수 있는 새 컴퍼지션 표면 개체를 만듭니다.

구문

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

매개 변수

[in] desiredAccess

형식: DWORD

컴퍼지션 표면 개체에 대한 요청된 액세스 권한입니다. 다음 값 중 하나일 수 있습니다.

값 의미
0x0000L
 권한이 없습니다.
COMPOSITIONSURFACE_READ
0x0001L
 읽기 권한입니다. 내부 전용입니다.
COMPOSITIONSURFACE_WRITE
0x0002L
 쓰기 권한입니다. 내부 전용입니다.
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
 읽기/쓰기 액세스. 다른 프로세스에서 표면을 복제하는 경우를 제외하고 항상 이 플래그를 지정합니다. 이 경우 desiredAccess 를 0으로 설정합니다.

[in, optional] securityAttributes

형식: SECURITY_ATTRIBUTES*

컴퍼지션 표면 개체의 보안 설명자를 포함하고 자식 프로세스를 만들 때 컴퍼지션 표면 개체의 핸들을 상속할 수 있는지 여부를 지정합니다. 이 매개 변수가 NULL인 경우 컴퍼지션 표면 개체는 현재 프로세스에 대한 읽기 및 쓰기 액세스 권한을 부여하지만 자식 프로세스에서 핸들을 상속할 수 없도록 하는 기본 보안 특성으로 만들어집니다.

[out] surfaceHandle

형식: HANDLE*

새 컴퍼지션 표면 개체의 핸들입니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 dcomp.h
라이브러리 Dcomp.lib
DLL Dcomp.dll