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 포함)

추가 정보

DDVIDEOPORTINFO

DdVideoPortUpdate