D3DDDIARG_OPENRESOURCE 구조체(d3dumddi.h)

  • 아티클

D3DDDIARG_OPENRESOURCE 구조에는 공유 리소스를 열기 위한 정보가 포함되어 있습니다.

구문

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

멤버

[in] NumAllocations

pOpenAllocationInfo로 지정된 배열의 요소 수입니다. NumAllocations는 열 할당 수를 나타냅니다.

[in] pOpenAllocationInfo

열 리소스의 할당을 설명하는 D3DDDI_OPENALLOCATIONINFO 구조의 배열입니다.

[in] 열 리소스의 할당을 설명하는 D3DDDI_OPENALLOCATIONINFO 구조의 배열입니다.

pOpenAllocationInfo2

이 멤버는 예약되어 있으며 0으로 설정해야 합니다.

이 멤버는 Windows 7부터 사용할 수 있습니다.

[in] hKMResource

할당과 연결된 리소스에 대한 커널 모드 핸들을 나타내는 D3DKMT_HANDLE 데이터 형식입니다.

이 커널 모드 핸들은 사용자 모드 표시 드라이버의 CreateResource 함수를 호출하여 이전에 만든 기존 공유 리소스를 나타냅니다.

[in] pPrivateDriverData

리소스를 만들 때 디스플레이 미니포트 드라이버에 전달된 프라이빗 데이터에 대한 포인터입니다. 이 데이터는 리소스당이며 각 할당의 D3DDDI_OPENALLOCATIONINFO 구조에 있는 프라이빗 데이터와 같이 할당당이 아닙니다.

[in] PrivateDriverDataSize

pPrivateDriverData에서 가리키는 개인 데이터의 크기(바이트)입니다.

[in/out] hResource

할당과 연결된 리소스에 대한 핸들입니다.

사용자 모드 디스플레이 드라이버는 이 핸들을 저장하고 이를 사용하여 드라이버가 Microsoft Direct3D 런타임으로 다시 호출할 때마다 리소스를 식별해야 합니다. 사용자 모드 디스플레이 드라이버는 고유한 핸들을 생성하고 Direct3D 런타임에 다시 전달해야 합니다. Direct3D 런타임은 드라이버 호출에서 이 핸들을 사용하여 리소스를 식별합니다.

[in] Rotation

공유 주 리소스의 방향을 식별하는 D3DDDI_ROTATION 형식의 값입니다.

기본 리소스를 전체 화면 디바이스와 함께 사용하고 회전하는 경우 드라이버는 전체 화면 디바이스를 처리하기 위해 중간 할당을 만들어야 할 수 있습니다. 기본 리소스가 전체 화면 디바이스와 함께 사용됨을 나타내기 위해 Flags 멤버에 전체 화면 비트 필드 플래그가 설정됩니다.

[in] Flags

열 리소스의 유형을 식별하는 D3DDDI_OPENRESOURCEFLAGS 구조체입니다.

설명

Primary 및 SharedResource 비트 필드 플래그는 CreateResource 함수를 호출하여 공유 주 리소스를 만드는 D3DDDIARG_CREATERESOURCE 구조의 Flags 멤버에 설정됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글 d3dumddi.h(D3dumddi.h 포함)

추가 정보

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource