D3DKMTShareObjects 함수(d3dkmthk.h)

D3DKMTCreateAllocation, D3DKMTCreateKeyedMutex2 및 D3DKMTCreateSynchronizationObject2 함수를 사용하여 만든 리소스 개체를 공유합니다.

구문

NTSTATUS D3DKMTShareObjects(
  [in]  UINT                cObjects,
  [in]  const D3DKMT_HANDLE *hObjects,
  [in]  POBJECT_ATTRIBUTES  pObjectAttributes,
  [in]  DWORD               dwDesiredAccess,
  [out] HANDLE              *phSharedNtHandle
);

매개 변수

[in] cObjects

hObjects 매개 변수에 지정된 리소스 개체의 수입니다.

리소스 개체의 수는 D3DKMT_MAX_OBJECTS_PER_HANDLE 미만이거나 같아야 합니다.

[in] hObjects

공유할 리소스 개체를 지정하는 로컬 커널 모드 핸들 배열에 대한 포인터입니다.

hObjects 사용에 대한 자세한 내용은 설명 섹션을 참조 하세요.

[in] pObjectAttributes

리소스 개체의 특성을 지정하는 OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다.

[in] dwDesiredAccess

리소스에 대한 읽기 및 쓰기 액세스를 지정합니다.

[out] phSharedNtHandle

리소스 개체를 지정하는 공유 NT 핸들에 대한 포인터입니다.

NtSecuritySharing 플래그 값이 설정되지 않은 경우 이 매개 변수는 NULL 이어야 합니다. 자세한 내용은 설명 섹션을 참조하세요.

반환 값

이 메서드는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

D3DKMTShareObjects 를 사용하여 공유할 개체는 먼저 NtSecuritySharing 플래그 값을 설정하여 만들어야 합니다. 이 플래그 값은 D3DKMT_CREATEALLOCATIONFLAGS, D3DKMT_CREATEKEYEDMUTEX2_FLAGS 및 D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS 구조에서 사용할 수 있습니다.

이 함수는 hObjects 매개 변수를 통해 다음 입력 개체 배열 형식 조합에 대해서만 핸들을 지정해야 합니다.

• 할당
• 할당, 키 뮤텍스 및 동기화 개체
• 동기화 개체

운영 체제는 다른 입력 핸들 조합을 거부합니다.

요구 사항

지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	유니버설
헤더	d3dkmthk.h(D3dkmthk.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll

추가 정보

D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS

D3DKMTCreateAllocation

D3DKMTCreateKeyedMutex2

D3DKMTCreateSynchronizationObject2

D3DKMT_CREATEALLOCATIONFLAGS

D3DKMT_CREATEKEYEDMUTEX2_FLAGS