DD_UPDATEVPORTDATA 구조체(ddrawint.h)
DD_UPDATEVPORTDATA 구조에는 VPE(비디오 포트 확장) 개체를 시작, 중지 및 변경하는 데 필요한 정보가 포함되어 있습니다.
구문
typedef struct _DD_UPDATEVPORTDATA {
PDD_DIRECTDRAW_LOCAL lpDD;
PDD_VIDEOPORT_LOCAL lpVideoPort;
PDD_SURFACE_INT *lplpDDSurface;
PDD_SURFACE_INT *lplpDDVBISurface;
PDD_VIDEOPORTINFO lpVideoInfo;
DWORD dwFlags;
DWORD dwNumAutoflip;
DWORD dwNumVBIAutoflip;
HRESULT ddRVal;
VOID *UpdateVideoPort;
} *PDD_UPDATEVPORTDATA, DD_UPDATEVPORTDATA;
멤버
lpDD
현재 Microsoft DirectDraw 프로세스와만 관련된 DD_DIRECTDRAW_LOCAL 구조를 가리킵니다.
lpVideoPort
이 VPE 개체를 나타내는 DD_VIDEOPORT_LOCAL 구조를 가리킵니다.
lplpDDSurface
일반 비디오 화면을 나타내는 DD_SURFACE_INT 구조체의 배열을 가리킵니다. 이 멤버는 NULL일 수 있습니다.
lplpDDVBISurface
VBI 표면을 나타내는 DD_SURFACE_INT 구조체의 배열을 가리킵니다. 이 멤버는 NULL일 수 있습니다.
lpVideoInfo
VPE 개체가 비디오 데이터를 표면으로 전송하는 방법을 설명하는 DDVIDEOPORTINFO 구조를 가리킵니다. dwFlags가 DDRAWI_VPORTSTOP 경우 이 멤버는 NULL일 수 있습니다.
dwFlags
VPE 개체에서 수행할 작업을 나타냅니다. 이 멤버는 다음 값 중 하나여야 합니다.
| 플래그 | 의미 |
|---|---|
| DDRAWI_VPORTSTART | 드라이버는 VPE 개체를 통해 데이터 흐름을 시작해야 합니다. |
| DDRAWI_VPORTSTOP | 드라이버는 VPE 개체를 통한 데이터 흐름을 중지해야 합니다. |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate는 lpVideoInfo가 가리키는 DDVIDEOPORTINFO 구조체의 dwVPFlags 멤버에 새 플래그 집합을 사용하여 호출되었습니다. 드라이버는 새 플래그에 따라 VPE 개체를 통해 데이터 흐름을 변경해야 합니다. |
dwNumAutoflip
lplpDDSurface가 가리키는 목록의 표면 수를 지정합니다. 이 멤버가 1보다 큰 경우 lplpDDSurface 는 자동 플리핑을 수용하기 위한 표면 구조의 배열입니다.
dwNumVBIAutoflip
lplpDDVBISurface가 가리키는 목록의 표면 수를 지정합니다. 이 멤버가 1보다 큰 경우 lplpDDVBISurface 는 VBI 데이터의 자동 매핑을 수용하기 위한 표면 구조의 배열입니다.
ddRVal
드라이버가 DdVideoPortUpdate 콜백의 반환 값을 쓰는 위치를 지정합니다. DD_OK 반환 코드는 성공을 나타냅니다. 자세한 내용은 DirectDraw에 대한 반환 값을 참조하세요.
UpdateVideoPort
DirectDraw API에서 사용되며 드라이버에서 입력하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | ddrawint.h(Winddi.h 포함) |