DrvGetDirectDrawInfo 함수(winddi.h)

아티클
03/13/2024

DrvGetDirectDrawInfo 함수는 그래픽 하드웨어의 기능을 반환합니다.

구문

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

매개 변수

dhpdev

드라이버의 DrvEnablePDEV 루틴에서 반환된 PDEV에 대한 핸들입니다.

pHalInfo

드라이버가 지원하는 하드웨어 기능을 반환해야 하는 DD_HALINFO 구조를 가리킵니다.

pdwNumHeaps

드라이버가 pvmList에서 가리키는 VIDEOMEMORY 구조체의 수를 반환해야 하는 위치를 가리킵니다.

pvmList

드라이버가 제어하는 각 디스플레이 메모리 청크에 대한 정보를 반환해야 하는 VIDEOMEMORY 구조체의 배열을 가리킵니다. 드라이버가 NULL인 경우 이 매개 변수를 무시해야 합니다.

pdwNumFourCCCodes

드라이버가 pdwFourCC가 가리키는 DWORD 수를 반환해야 하는 위치를 가리킵니다.

pdwFourCC

드라이버가 지원하는 각 FOURCC 에 대한 정보를 반환해야 하는 DWORD 배열을 가리킵니다. 드라이버가 NULL인 경우 이 매개 변수를 무시해야 합니다.

반환 값

DrvGetDirectDrawInfo 는 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.

설명

드라이버의 DrvGetDirectDrawInfo 루틴은 다음을 수행해야 합니다.

pvmList 및 pdwFourCC가 NULL인 경우:
1. DirectDraw 사용을 위해 오프스크린 디스플레이 메모리를 예약합니다.
2. 각각 pdwNumHeaps 및 pdwNumFourCC에서 드라이버 디스플레이 메모리 힙 및 지원되는 FOURC 수를 작성합니다.
pvmList 및 pdwFourCC가 NULL이 아닌 경우:
1. 각각 pdwNumHeaps 및 pdwNumFourCC에서 드라이버 디스플레이 메모리 힙 및 지원되는 FOURC 수를 작성합니다.
2. pvmList가 가리키는 목록의 각 VIDEOMEMORY 구조에 대해 적절한 멤버를 입력하여 특정 디스플레이 메모리 청크를 설명합니다. 구조 목록은 드라이버의 오프스크린 메모리에 대한 전체 설명과 함께 DirectDraw를 제공합니다.
다음과 같이 드라이버별 정보를 사용하여 DD_HALINFO 구조체의 멤버를 초기화합니다.
1. vmiData에서 VIDEOMEMORYINFO 구조체의 적절한 멤버를 초기화하여 디스플레이 메모리의 일반적인 특성을 설명합니다.
2. ddCaps에서 DDCORECAPS 구조체의 적절한 멤버를 초기화하여 하드웨어의 기능을 설명합니다.
3. 드라이버가 DdGetDriverInfo 함수를 구현하는 경우 GetDriverInfo 를 가리키도록 설정하고 dwFlags를 DDHALINFO_GETDRIVERINFOSET 설정합니다.