D3DDDIARG_CREATEDEVICE 구조체(d3dumddi.h)

  • 아티클

D3DDDIARG_CREATEDEVICE 구조에는 만들 디스플레이 디바이스를 설명하는 정보가 포함되어 있습니다.

구문

typedef struct _D3DDDIARG_CREATEDEVICE {
  [in/out] HANDLE                       hDevice;
  [in]     UINT                         Interface;
  [in]     UINT                         Version;
  [in]     const D3DDDI_DEVICECALLBACKS *pCallbacks;
  [in]     VOID                         *pCommandBuffer;
  [in]     UINT                         CommandBufferSize;
  [in]     D3DDDI_ALLOCATIONLIST        *pAllocationList;
  [in]     UINT                         AllocationListSize;
  [in]     D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  [in]     UINT                         PatchLocationListSize;
           D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  [in]     D3DDDI_CREATEDEVICEFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
} D3DDDIARG_CREATEDEVICE;

멤버

[in/out] hDevice

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다. CreateDevice 함수에 대한 입력 시 hDevice는 드라이버가 Microsoft Direct3D 런타임으로 다시 호출할 때 사용해야 하는 핸들을 지정합니다.

드라이버는 고유한 핸들을 생성하고 Direct3D 런타임에 다시 전달합니다. CreateDevice 함수의 출력에서 hDevice는 Direct3D 런타임이 디스플레이 디바이스를 식별하기 위해 후속 드라이버 호출에서 사용하는 핸들을 지정합니다.

[in] Interface

디바이스를 만드는 Direct3D/DirectDraw 인터페이스 버전(예: 7, 8 또는 9)입니다.

[in] Version

드라이버가 Direct3D/DirectDraw 런타임이 빌드된 시기를 식별하는 데 사용할 수 있는 숫자입니다. 예를 들어 드라이버는 버전 번호를 사용하여 Windows Vista에서 릴리스된 런타임과 드라이버에 필요한 수정 사항이 포함될 수 있는 후속 서비스 팩으로 릴리스된 런타임을 구분할 수 있습니다.

[in] pCallbacks

드라이버에서 사용할 수 있는 Direct3D 런타임 콜백 함수 테이블을 포함하는 D3DDDI_DEVICECALLBACKS 구조체에 대한 포인터입니다.

[in] pCommandBuffer

사용되지 않습니다. 사용자 모드 표시 드라이버가 일괄 처리 명령에 사용할 수 있는 첫 번째 버퍼에 대한 포인터를 받으려면 먼저 pfnCreateContextCb 함수를 호출하여 새로 만든 디바이스에 대한 컨텍스트를 만들어야 합니다.

[in] CommandBufferSize

사용되지 않습니다.

[in] pAllocationList

사용되지 않습니다. 시작 할당 목록에 대한 D3DDDI_ALLOCATIONLIST 구조의 배열을 받으려면 드라이버는 먼저 pfnCreateContextCb 함수를 호출하여 새로 만든 디바이스에 대한 컨텍스트를 만들어야 합니다.

[in] AllocationListSize

사용되지 않습니다.

[in] pPatchLocationList

사용되지 않습니다. 시작 패치 위치 목록에 대한 D3DDDI_PATCHLOCATIONLIST 구조의 배열을 받으려면 드라이버는 먼저 pfnCreateContextCb 함수를 호출하여 새로 만든 디바이스에 대한 컨텍스트를 만들어야 합니다.

[in] PatchLocationListSize

사용되지 않습니다.

pDeviceFuncs

[out] 사용자 모드 표시 드라이버가 함수의 테이블로 채우는 D3DDDI_DEVICEFUNCS 구조체에 대한 포인터입니다. Direct3D 런타임은 이러한 함수를 사용하여 사용자 모드 디스플레이 드라이버와 통신합니다.

[in] Flags

디바이스를 만드는 방법을 식별하는 D3DDDI_CREATEDEVICEFLAGS 구조체입니다.

CommandBuffer

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

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

요구 사항

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

추가 정보

CreateDevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice