PFND3DDDI_GETCAPS 콜백 함수(d3dumddi.h)

아티클
08/07/2023

D3D 런타임은 드라이버의 PFND3DDDI_GETCAPS 콜백 함수를 호출하여 그래픽 어댑터의 기능을 쿼리합니다.

구문

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

매개 변수

hAdapter

그래픽 어댑터를 식별하는 핸들입니다.

unnamedParam2

pData [in, out]

검색할 기능을 설명하는 D3DDDIARG_GETCAPS 구조체에 대한 포인터입니다.

반환 값

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

반환 코드	설명
S_OK	기능이 성공적으로 검색되었습니다.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS 완료하는 데 필요한 메모리를 할당할 수 없습니다.

설명

D3DDDIARG_GETCAPS 구조체의 pData 멤버에 반환되는 데이터는 요청된 데이터 형식에 따라 달라집니다(즉, 데이터는 D3DDDIARG_GETCAPS 따라 달라집니다. pInfo 멤버에 및 를 입력합니다.

다음 표에는 D3DDDIARG_GETCAPS 값에 따라 PFND3DDDI_GETCAPS 호출을 설정하는 방법에 대한 두 가지 예제가 있습니다. 를 입력합니다.

D3DDDIARG_GETCAPS 멤버	예 1	예 2
형식	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL(조건이 설정되지 않음)	[in] NULL(조건이 설정되지 않음)
pData	[out] DDRAW_CAPS (고유 포인터)	[out] UINT* (고유 포인터)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
참고	드라이버는 DDRAW_CAPS 구조를 지원하는 DirectDraw 기능으로 채워야 합니다.	드라이버는 pData 가 가리키는 버퍼를 디바이스가 지원하는 D3DDDIFORMAT 표면 형식의 수를 나타내는 UINT 값으로 채워야 합니다.

D3DDDIARG_GETCAPS 다른 값에 대한 설명은 D3DDDIARG_GETCAPS 참조하세요. 다중 평면 오버레이에 사용되는 형식입니다.

Simple_instancing

WDDM(Windows 디스플레이 드라이버 모델) 1.3 이상을 지원하는 Direct3D 수준 9 드라이버가 PFND3DDDI_GETCAPS 호출을 완료하고 S_OK 반환하지만 D3DDDIARG_GETCAPS 구조의 데이터를 변경하지 않는 경우 하드웨어 및 드라이버가 간단한 인스턴스화를 지원하지 않는다는 것을 Direct3D 런타임에 나타냅니다. 자세한 내용은 D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT 참조하세요.