IDisplayDeviceInterop::OpenSharedHandle 메서드(windows.devices.display.core.interop.h)

  • 아티클

공유 기본 표면, 공유 펜스 및 원본 프레젠테이션 핸들에 대한 핸들을 엽니다.

구문

HRESULT OpenSharedHandle(
  HANDLE NTHandle,
  IID    riid,
  void   **ppvObj
);

매개 변수

NTHandle

형식: HANDLE

공유 기본 표면, 공유 펜스 또는 원본 프레젠테이션 핸들에 대한 NT 핸들입니다.

riid

형식: REFIID

다음 Windows 런타임 클래스 중 하나의 기본 인터페이스에 대한 IID(인터페이스 식별자)에 대한 참조입니다. IID는 GUID입니다.

ppvObj

형식: void**

riid 인수로 지정된 인터페이스에 대한 포인터를 수신하는 메모리 블록에 대한 포인터입니다.

반환 값

형식: HRESULT

성공 시 S_OK 반환하거나 실패 시 문제를 설명하는 오류 코드를 반환합니다.

설명

이 메서드를 사용하여 공유 펜스를 열 수 있지만 기본으로 만들어진 경우에만 표면을 열 수 있습니다. 기본 표면은 디스플레이 하드웨어에서 스캔하는 데 직접 사용할 수 있는 표면입니다. 대부분의 일반적인 Direct3D 표면은 스왑 체인 백 버퍼에 사용하기 위해 만들어진 경우가 아니면 주 표면으로 만들어지지 않습니다. DisplayDevice.CreatePrimary 는 항상 스캔하는 데 사용되므로 항상 표면을 기본으로 만듭니다.

원본 프레젠테이션 핸들을 여는 것은 프레젠테이션 핸들의 대상에 대해 CreateScanoutSource를 호출하는 것과 유사합니다. 단, 핸들을 만든 동일한 DisplayManager에서 DisplayDevice를 만들 필요는 없습니다. 이렇게 하면 세분화된 액세스 제어가 가능합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 빌드 20348
지원되는 최소 서버 Windows 10 빌드 20348
대상 플랫폼 Windows
헤더 windows.devices.display.core.interop.h
라이브러리 d3d12.lib
DLL d3d12.dll

추가 정보