D3DHAL_DRAWPRIMITIVES2DATA 구조체(d3dhal.h)

D3DHAL_DRAWPRIMITIVES2DATA 구조체에는 D3dDrawPrimitives2 함수가 기본 형식을 렌더링하는 데 필요한 정보가 포함되어 있습니다.

구문

typedef struct _D3DHAL_DRAWPRIMITIVES2DATA {
  ULONG_PTR                 dwhContext;
  DWORD                     dwFlags;
  DWORD                     dwVertexType;
  LPDDRAWI_DDRAWSURFACE_LCL lpDDCommands;
  DWORD                     dwCommandOffset;
  DWORD                     dwCommandLength;
  union {
    LPDDRAWI_DDRAWSURFACE_LCL lpDDVertex;
    LPVOID                    lpVertices;
  };
  DWORD                     dwVertexOffset;
  DWORD                     dwVertexLength;
  DWORD                     dwReqVertexBufSize;
  DWORD                     dwReqCommandBufSize;
  LPDWORD                   lpdwRStates;
  union {
    DWORD   dwVertexSize;
    HRESULT ddrval;
  };
  DWORD                     dwErrorOffset;
} D3DHAL_DRAWPRIMITIVES2DATA;

멤버

dwhContext

Direct3D 디바이스의 컨텍스트 핸들을 지정합니다.

dwFlags

드라이버에 추가 지침을 제공하거나 드라이버의 정보를 제공하는 플래그를 지정합니다. 이 멤버는 다음 값 중 비트 OR일 수 있습니다.

dwVertexType

꼭짓점 버퍼에 있는 데이터의 FVF 를 식별합니다. 즉, dwVertexType 은 lpDDVertex 또는 lpVertices 가 가리키는 꼭짓점 버퍼에 있는 꼭짓점별 데이터 필드를 지정합니다. 이 멤버는 다음 표에 있는 값의 비트 OR일 수 있습니다. D3DFVF_TEXx 플래그 중 하나만 설정됩니다.

lpDDCommands

dwCommandOffset

dwCommandLength

lpDDCommands가 dwCommandOffset에서 시작하도록 가리키는 표면의 유효한 명령 데이터의 바이트 수를 지정합니다.

lpDDVertex

D3DHALDP2_USERMEMVERTICES 플래그가 dwFlags에 설정되지 않은 경우 꼭짓점 데이터가 포함된 DirectDraw 표면을 식별하는 DD_SURFACE_LOCAL 구조를 가리킵니다. lpVertices를 사용하여 공용 구조체를 형성합니다.

lpVertices

D3DHALDP2_USERMEMVERTICES 플래그가 dwFlags에 설정된 경우 꼭짓점 데이터가 포함된 사용자 모드 메모리 블록을 가리킵니다.

dwVertexOffset

꼭짓점 데이터가 시작되는 lpDDVertex 또는 lpVertices 가 가리키는 표면의 바이트 수를 지정합니다.

dwVertexLength

lpDDVertex 또는 lpVertices가 가리키는 표면에 유효한 데이터가 있는 꼭짓점 수를 지정합니다. 이 유효한 데이터는 dwVertexOffset에서 시작됩니다.

dwReqVertexBufSize

드라이버가 스왑 꼭짓점 버퍼에 할당해야 하는 최소 바이트 수를 지정합니다. 이 멤버는 D3DHALDP2_REQVERTEXBUFSIZE 플래그가 설정된 경우에만 유효합니다. 꼭짓점 버퍼의 다중 버퍼링을 지원하지 않는 드라이버는 이 멤버를 무시해야 합니다.

dwReqCommandBufSize

드라이버가 스왑 명령 버퍼를 늘려야 하는 최소 바이트 수를 지정합니다. 이 멤버는 D3DHALDP2_REQCOMMANDBUFSIZE 플래그가 설정된 경우에만 유효합니다. 명령 버퍼의 다중 버퍼링을 지원하지 않는 드라이버는 이 멤버를 무시해야 합니다.

lpdwRStates

명령 버퍼에서 렌더링 상태 명령을 구문 분석할 때 드라이버가 업데이트해야 하는 렌더링 상태 배열을 가리킵니다. 드라이버는 D3DHALDP2_EXECUTEBUFFER 플래그가 dwFlags에 설정된 경우에만 이 배열을 업데이트해야 합니다. 드라이버는 D3DRENDERSTATETYPE 열거형 형식을 사용하여 렌더링 상태 배열의 적절한 요소를 업데이트해야 합니다.

dwVertexSize

각 꼭짓점의 크기를 바이트 단위로 지정합니다. 이 멤버는 ddrval을 사용하여 공용 구조체를 형성합니다.

ddrval

드라이버가 D3dDrawPrimitives2의 반환 값을 쓰는 위치를 지정합니다. D3D_OK 성공을 나타냅니다. 그렇지 않으면 드라이버가 적절한 D3DERR_Xxx 오류 코드를 반환해야 합니다. 자세한 내용은 Direct3D 드라이버 콜백에 대한 반환 코드를 참조하세요.

dwErrorOffset

각 D3DHAL_DP2RESPONSEQUERY 뒤에 쿼리와 관련된 다음 데이터가 잇습니다.

• D3DQUERYTYPE_EVENT 대한 BOOL
• DWORD for D3DQUERYTYPE_OCCLUSION
• D3DQUERYTYPE_VCACHE 대한 D3DDEVINFO_VCACHE 구조체

설명

dwVertexOffset 멤버는 값을 바이트 단위로 지정합니다. dwVertexLength 멤버는 꼭짓점의 값을 지정합니다.

lpDDVertex 또는 lpVertices의 표면에 있는 유효한 데이터를 바이트 단위로 계산하려면 dwVertexLength의 값을 dwVertexSize의 값과 곱합니다.

요구 사항

추가 정보

D3DHAL_DP2COMMAND

D3DRENDERSTATETYPE

D3dDrawPrimitives2

DD_SURFACE_GLOBAL

DD_SURFACE_LOCAL