DrvDescribePixelFormat 함수(winddi.h)

DrvDescribePixelFormat 함수는 PIXELFORMATDESCRIPTOR 구조에 픽셀 형식 설명을 작성하여 디바이스 지정 PDEV의 픽셀 형식을 설명합니다.

구문

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

매개 변수

dhpdev

픽셀 형식 정보가 요청되는 디바이스를 식별합니다.

iPixelFormat

요청된 픽셀 형식의 인덱스 번호를 지정합니다.

cjpfd

ppfd가 가리키는 구조체에 쓸 수 있는 최대 바이트 수를 지정합니다.

ppfd

픽셀 형식에 대한 정보를 수신하는 PIXELFORMATDESCRIPTOR 구조체(Microsoft Windows SDK 설명서에 설명됨)에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

함수가 성공한 경우 반환 값은 최대 픽셀 형식 인덱스입니다. 그렇지 않으면 0이고 오류 코드가 기록됩니다.

설명

3D 그래픽 하드웨어를 지원하는 디스플레이 드라이버는 단일 디스플레이 화면에서 다양한 픽셀 형식의 창을 지원할 수 있습니다. 픽셀 형식은 그래픽 하드웨어에서 지원하는 구성에 해당해야 합니다.

이 매개 변수가 NULL이 아닌 경우 DrvDescribePixelFormat은 ppfd가 가리키는 구조를 채웁니다.

반환된 최대 픽셀 형식 인덱스는 디바이스 컨텍스트의 최대 픽셀 형식 인덱스를 가져와야 하는 애플리케이션에서 사용할 수 있습니다. 디바이스에서 지원하는 픽셀 형식은 양의 1 기반 정수 인덱스로 식별됩니다.

픽셀 형식 함수는 창 개체 서비스 함수와 함께 사용하여 디스플레이 화면에서 창의 픽셀 형식을 추적하고 업데이트합니다.

요구 사항

대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)