DrvGetModes 함수(winddi.h)

아티클
03/04/2024

DrvGetModes 함수는 지정된 디바이스에서 지원하는 모드를 나열합니다.

구문

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

매개 변수

[in] hDriver

모드를 열거해야 하는 드라이버에 대한 핸들입니다. DrvEnablePDEV 함수의 hDriver 매개 변수에 전달된 핸들입니다.

cjSize

pdm이 가리키는 버퍼의 크기(바이트)를 지정합니다.

[out, optional] pdm

드라이버가 채울 DEVMODEW 구조체 또는 NULL을 포함하는 버퍼에 대한 포인터입니다.

반환 값

pdm이 NULL이 아닌 경우 드라이버는 버퍼에 기록된 바이트 수를 반환해야 합니다. pdm이 NULL인 경우 드라이버는 모든 모드 데이터를 보유하는 데 필요한 바이트 수를 반환해야 합니다. 오류가 발생하면 드라이버가 0을 반환해야 합니다.

설명

이 함수는 모든 디스플레이 드라이버에서 구현되어야 합니다.

Window Manager는 미니포트 드라이버와 연결된 모든 디스플레이 드라이버를 동적으로 로드합니다(레지스트리의 InstalledDisplayDrivers 키 기반). 각 디스플레이 드라이버는 로드된 드라이버 조합에서 지원하는 모드 목록을 검색하기 위해 호출됩니다. 예를 들어 VGA64K 디스플레이 드라이버는 미니포트 드라이버에서 가져온 모드 목록에서 반환된 64K 색 모드만 반환합니다.

활성 PDEV가 있기 전에 DrvGetModes를 호출할 수 있습니다.

DrvGetModes의 작동 구현을 보려면 Permedia 샘플을 참조하세요.

참고 Microsoft WDK(Windows 드라이버 키트)에는 3Dlabs Permedia2(3dlabs.htm ) 및 3Dlabs Permedia3(Perm3.htm) 샘플 디스플레이 드라이버가 포함되어 있지 않습니다. WDHC 웹 사이트의 DDK - Windows 드라이버 개발 키트 페이지에서 다운로드할 수 있는 Windows Server 2003 SP1 DDK(드라이버 개발 키트 )에서 이러한 샘플 드라이버를 가져올 수 있습니다.