PFND3DDDI_GETCAPS 콜백 함수(d3dumddi.h)

아티클
02/06/2025

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)
노트	드라이버는 지원하는 DirectDraw 기능으로 DDRAW_CAPS 구조를 채워야 합니다.	드라이버는 pData 가리키는 버퍼를 디바이스에서 지원하는 D3DDDIFORMAT 표면 형식의 수를 나타내는 UINT 값으로 채워야 합니다.

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

Simple_instancing

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