D3DDDICB_ALLOCATE 구조체(d3dumddi.h)

아티클
02/23/2024

D3DDDICB_ALLOCATE 구조에는 메모리 할당에 대한 정보가 포함되어 있습니다.

구문

typedef struct _D3DDDICB_ALLOCATE {
  [in]  const VOID            *pPrivateDriverData;
  [in]  UINT                  PrivateDriverDataSize;
  [in]  HANDLE                hResource;
  [out] D3DKMT_HANDLE         hKMResource;
  [in]  UINT                  NumAllocations;
  union {
    [in]  D3DDDI_ALLOCATIONINFO  *pAllocationInfo;
    [in]  D3DDDI_ALLOCATIONINFO2 *pAllocationInfo2;
  };
  [in]  D3DDDI_ALLOCATIONINFO *pAllocationInfo;
} D3DDDICB_ALLOCATE;

멤버

[in] pPrivateDriverData

디스플레이 미니포트 드라이버에 전달되는 프라이빗 데이터에 대한 포인터입니다. 이 데이터는 리소스당이며 할당당이 아닙니다. 할당이 기존 리소스에 연결된 경우 현재 데이터는 이전 데이터를 덮어써야 합니다.

[in] PrivateDriverDataSize

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

[in] hResource

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

사용자 모드 표시 드라이버가 pfnAllocateCb 함수를 호출하는 경우 드라이버는 CreateResource(D3D10) 또는 CreateResource(D3D11)에 대한 호출에서 D3DDDIARG_CREATERESOURCE 구조체의 hResource 멤버 또는 hRTResource 매개 변수로부터 받은 값을 할당해야 합니다. 할당을 리소스와 연결하는 값을 할당하거나 NULL 을 할당하여 할당을 디바이스와 연결해야 합니다. 드라이버는 공유 리소스에 대한 응답으로 생성된 할당에 대해 NULL 이 아닌 값을 할당해야 합니다. 공유 리소스는 D3DDDIARG_CREATERESOURCE Flags 멤버에 설정된 SharedResource 비트 필드 플래그가 있는 CreateResource 호출에서 발생할 수 있습니다. 또한 CreateResource(D3D10) 또는 CreateResource(D3D11) 호출에서 발생할 수 있으며 D3D10_DDI_RESOURCE_MISC_SHARED 값은 D3D10DDIARG_CREATERESOURCE 또는 D3D11DDIARG_CREATERESOURCEMiscFlags 멤버에 설정됩니다.

Microsoft Direct3D 런타임은 드라이버 호출에서 이 핸들을 사용하여 리소스를 식별해야 합니다.

[out] hKMResource

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

Direct3D 런타임은 사용자 모드 표시 드라이버가 D3DDDICB_ALLOCATE hResource 멤버를 D3DDDIARG_CREATERESOURCE 구조의hResource 멤버로부터 받은 사용자 모드 런타임 리소스 핸들로 설정하는 경우에만 커널 모드 리소스 핸들을 만들고 반환합니다. 이 핸들은 CreateResource 호출 또는 CreateResource (D3D10) 또는 CreateResource(D3D11) 호출의 hResource 매개 변수에서 수신됩니다.

Direct3D 런타임은 고유한 핸들을 생성하고 사용자 모드 디스플레이 드라이버에 다시 전달합니다. 사용자 모드 디스플레이 드라이버는 디스플레이 미니포트 드라이버에서 나중에 사용하기 위해 커널 모드 리소스 핸들을 명령 스트림에 삽입할 수 있습니다.

[in] NumAllocations

할당할 할당 수를 나타내는 pAllocationInfo의 배열에 있는 요소 수입니다.

[in] pAllocationInfo

할당할 할당을 설명하는 D3DDDI_ALLOCATIONINFO 구조체의 배열입니다.

[in] 할당할 할당을 설명하는 D3DDDI_ALLOCATIONINFO 구조체의 배열입니다.

[in] pAllocationInfo2

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

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

요구 사항

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