LPD3DHAL_CONTEXTCREATECB 콜백 함수(d3dhal.h)
D3dContextCreate 함수는 컨텍스트를 만듭니다.
구문
LPD3DHAL_CONTEXTCREATECB Lpd3dhalContextcreatecb;
DWORD Lpd3dhalContextcreatecb(
LPD3DHAL_CONTEXTCREATEDATA unnamedParam1
)
{...}
매개 변수
unnamedParam1
pccd [in]
컨텍스트를 만드는 데 필요한 정보와 드라이버가 새 컨텍스트에 저장해야 하는 데이터를 포함하는 D3DHAL_CONTEXTCREATEDATA 구조를 가리킵니다.
반환 값
D3dContextCreate 는 다음 콜백 코드 중 하나를 반환합니다.
설명
D3dContextCreate 는 Microsoft Direct3D를 지원하는 드라이버에서 구현되어야 합니다. 다음 단계를 수행해야 합니다.
- 드라이버가 렌더링을 수행하는 데 필요한 모든 정보를 사용하여 드라이버의 컨텍스트를 초기화합니다. 여기에는 D3DHAL_CONTEXTCREATEDATA 구조체의 lpDDSLcl 및 lpDDSZLcl 멤버가 각각 pccd 지점과 컨텍스트를 가리키는 렌더링 대상 및 깊이 버퍼를 연결합니다.
- 이 새 컨텍스트에 대한 고유한 컨텍스트 ID를 생성하고 D3DHAL_CONTEXTCREATEDATA dwhContext 멤버에 반환합니다. Direct3D는 이 Direct3D 디바이스에 대한 모든 후속 콜백에서 이 컨텍스트 ID를 사용합니다. 드라이버는 0의 컨텍스트 핸들을 만들면 안 됩니다.
- 성공 시 DD_OK D3DHAL_CONTEXTCREATEDATA ddrval 멤버를 설정하고 컨텍스트를 만들 수 없는 경우 D3DHAL_OUTOFCONTEXTS.
- DDHAL_DRIVER_HANDLED 반환합니다.
상태는 컨텍스트 간에 공유되지 않습니다. 따라서 드라이버는 각 컨텍스트에 대한 전체 상태 정보를 유지 관리해야 합니다. 이 상태는 D3dDrawPrimitives2에 대한 후속 호출에 의해 변경됩니다.
드라이버는 컨텍스트 내에서 생성된 모든 텍스처 핸들을 참조할 수 있어야 합니다. 그런 다음 D3dContextDestroy 호출이 수행되면 드라이버가 이 컨텍스트 내에서 만든 텍스처와 관련된 모든 드라이버 관련 데이터를 클린 수 있습니다.
사용하지 않도록 설정된 PDEV를 사용하여 D3dContextCreate를 호출할 수 있습니다. 디스플레이 드라이버의 DrvAssertMode 함수를 호출하여 PDEV를 사용하지 않도록 설정하거나 사용할 수 있습니다. 자세한 내용은 PDEV 관리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dhal.h(D3dhal.h 포함) |