D3DDDIARG_OPENADAPTER 구조체(d3dumddi.h)

D3DDDIARG_OPENADAPTER 구조체에는 그래픽 어댑터 개체를 설명하는 정보가 포함되어 있습니다.

구문

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

멤버

[in/out] hAdapter

그래픽 어댑터 개체에 대한 핸들입니다. OpenAdapter 함수에 대한 입력 시 hAdapter는 드라이버가 Microsoft Direct3D 런타임 제공 pfnQueryAdapterInfoCb 콜백 함수를 호출할 때 드라이버가 그래픽 어댑터 기능을 쿼리하는 데 사용해야 하는 핸들을 지정합니다.

드라이버는 고유한 핸들을 생성하고 Direct3D 런타임에 다시 전달합니다. OpenAdapter 함수의 출력에서 hAdapter는 Direct3D 런타임이 그래픽 어댑터 개체를 식별하기 위해 후속 드라이버 호출에 사용하는 핸들을 지정합니다.

[in] Interface

그래픽 어댑터를 여는 Direct3D/DirectDraw 인터페이스 버전(예: 7, 8 또는 9)입니다.

[in] Version

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

[in] pAdapterCallbacks

드라이버 에서 사용할 수 있는 Direct3D 런타임 제공 pfnQueryAdapterInfoCb 콜백 함수를 포함하는 D3DDDI_ADAPTERCALLBACKS 구조체에 대한 포인터입니다.

[out] pAdapterFuncs

사용자 모드 디스플레이 드라이버 어댑터 관련 함수 테이블이 포함된 D3DDDI_ADAPTERFUNCS 구조체에 대한 포인터입니다. Direct3D 런타임은 이러한 함수를 사용하여 그래픽 어댑터와 관련된 작업에 대해 사용자 모드 디스플레이 드라이버와 통신합니다.

[out] DriverVersion

드라이버가 컴파일된 D3dumddi.h 헤더 파일에서 가져온 Direct3D 사용자 모드 디스플레이 드라이버의 인터페이스 버전입니다. 사용자 모드 표시 드라이버는 D3D_UMD_INTERFACE_VERSION 반환해야 합니다.

참고 사용자 모드 드라이버가 Windows 7 기능(DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7)을 지원하지 않고 Windows 7 WDK(버전 7600)로 드라이버를 컴파일하려는 경우 드라이버가 D3D_UMD_INTERFACE_VERSION_VISTA 반환하는지 확인합니다.

 

요구 사항

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

추가 정보

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb