PFND3DDDI_QUERYADAPTERINFOCB 콜백 함수(d3dumddi.h)
pfnQueryAdapterInfoCb 함수는 그래픽 어댑터 정보를 검색합니다.
구문
PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;
HRESULT Pfnd3dddiQueryadapterinfocb(
HANDLE hAdapter,
const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}
매개 변수
hAdapter
그래픽 어댑터 개체에 대한 핸들입니다.
unnamedParam2
pData [in, out]
그래픽 하드웨어에 대한 정보를 수신하는 D3DDDICB_QUERYADAPTERINFO 구조체에 대한 포인터입니다.
반환 값
pfnQueryAdapterInfoCb 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 정보가 성공적으로 검색되었습니다. |
| E_INVALIDARG | 매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다. |
이 함수는 다른 HRESULT 값을 반환할 수도 있습니다.
설명
Microsoft Direct3D 런타임이 사용자 모드 디스플레이 드라이버의 CreateDevice 또는 CreateDevice(D3D10) 함수를 호출하여 그래픽 컨텍스트를 만들기 전에 사용자 모드 디스플레이 드라이버는 pfnQueryAdapterInfoCb를 호출하여 그래픽 하드웨어에 대한 정보를 검색해야 합니다. 이 순서는 다중 모니터 시스템에 특히 중요합니다.
pfnQueryAdapterInfoCb 호출에서 사용자 모드 표시 드라이버는 디스플레이 미니포트 드라이버가 구성 데이터로 채우는 버퍼를 보냅니다. 이 구성 데이터를 받은 후 사용자 모드 표시 드라이버는 런타임이 사용자 모드 디스플레이 드라이버의 GetCaps 및 GetCaps (D3D10_2) 함수를 호출할 때 해당 기능을 정확하게 보고할 수 있습니다. 런타임이 이후에 D3DDDI_DEVICEFUNCS,D3D10DDI_DEVICEFUNCS 또는 D3D11DDI_DEVICEFUNCS 구조에 지정된 다른 사용자 모드 표시 드라이버 함수를 호출하면 사용자 모드 표시 드라이버는 하드웨어에서 처리할 수 있는 명령 스트림을 생성할 수 있습니다.
예제
다음 코드 예제에서는 그래픽 어댑터 정보를 검색하는 방법을 보여 줍니다.
HRESULT hr;
// Query for GART segment support
D3DDDICB_QUERYADAPTERINFO ddiQueryAdapterInfo;
memset(&R200AdapterInfo, 0, sizeof(R200AdapterInfo));
ddiQueryAdapterInfo.pPrivateDriverData = &R200AdapterInfo;
ddiQueryAdapterInfo.PrivateDriverDataSize = sizeof(R200AdapterInfo);
hr = m_Callbacks.pfnQueryAdapterInfoCb(m_hAdapter, &ddiQueryAdapterInfo);
if (FAILED(hr)) {
return FALSE;
}
m_ulGartSupported = R200AdapterInfo.ulGartSupported;
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |