PFND3DDDI_GETMULTISAMPLEMETHODLISTCB 콜백 함수(d3dumddi.h)

아티클
08/07/2023

pfnGetMultisampleMethodListCb 함수는 할당의 지정된 너비, 높이 및 형식에 사용되는 다중 샘플 메서드 목록을 검색합니다.

구문

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

매개 변수

hAdapter

그래픽 어댑터 개체에 대한 핸들입니다.

unnamedParam2

pData [in, out]

할당에 대한 다중 샘플 메서드 목록을 설명하는 D3DDDICB_GETMULTISAMPLEMETHODLIST 구조체에 대한 포인터입니다.

반환 값

pfnGetMultisampleMethodListCb 는 다음 값 중 하나를 반환합니다.

반환 코드	설명
S_OK	다중 샘플 메서드 목록이 성공적으로 검색되었습니다.
E_INVALIDARG	매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다.

이 함수는 다른 HRESULT 값을 반환할 수도 있습니다.

설명

사용자 모드 표시 드라이버는 일반적으로 createResource, CreateResource(D3D10) 또는 CreateResource(D3D11) 함수 및 pfnAllocateCb 함수와 함께 pfnGetMultisampleMethodListCb 함수를 사용합니다. 드라이버는 Direct3D 런타임이 드라이버의 CreateResource, CreateResource(D3D10) 또는 CreateResource(D3D11)를 호출하여 드라이버가 다중 샘플링된 기본 데이터베이스를 만들 도록 요청할 때 pfnGetMultisampleMethodListCb를 사용합니다. 또한 드라이버는 주 데이터베이스에서 검사하는 동안 여러 샘플링을 수행해야 하는 경우 pfnGetMultisampleMethodListCb 를 사용합니다. 이러한 유형의 다중 샘플링은 디스플레이 모드를 검사하는 데 필요한 대역폭을 초과하여 추가 메모리 대역폭을 사용할 수 있습니다. 따라서 pfnGetMultisampleMethodListCb 는 DMM(디스플레이 모드 관리자) 및 간접적으로 디스플레이 미니포트 드라이버를 쿼리하여 지정된 너비, 높이 및 형식에 대해 지원되는 다중 샘플링 메서드 목록을 검색합니다. pfnGetMultisampleMethodListCb에서 지원되는 메서드가 없다고 보고하는 경우, 사용자 모드 표시 드라이버는 일반적으로 표준 비멀티플 샘플링 기본을 만들어서 아웃되지 않은 버전의 다중 샘플링을 사용해야 합니다.

요구 사항

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