PFND3DDDI_OFFERALLOCATIONSCB 콜백 함수(d3dumddi.h)
재사용을 위해 비디오 메모리 할당을 제공하기 위해 사용자 모드 디스플레이 드라이버에서 호출됩니다.
구문
PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;
HRESULT Pfnd3dddiOfferallocationscb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다. Direct3D 런타임은 이 핸들을 디바이스를 만들 때 D3DDDIARG_CREATEDEVICE 구조의 hDevice 멤버로 사용자 모드 드라이버를 전달했습니다.
unnamedParam2
pData [in]
드라이버에서 제공하는 비디오 메모리 할당을 정의하는 D3DDDICB_OFFERALLOCATIONS 구조체에 대한 포인터입니다.
반환 값
다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 할당이 성공적으로 제공되었습니다. 참고: 드라이버가 pfnOfferAllocationsCb를 호출할 필요가 없는 경우 S_OK 반환해야 합니다. |
| D3DDDIERR_DEVICEREMOVED | 플러그 앤 플레이(PnP) 중지 이벤트 또는 TDR(시간 제한 검색 및 복구) 이벤트가 발생했기 때문에 비디오 메모리 관리자 또는 디스플레이 미니포트 드라이버가 작업을 완료할 수 없습니다. 참고: 이 오류 코드가 반환되면 드라이버의 호출 함수(일반적으로 pfnOfferResources 루틴)는 이 오류 코드를 Direct3D 런타임에 반환해야 합니다. |
| E_INVALIDARG | 잘못된 매개 변수가 제공되었습니다. |
설명
사용자 모드 표시 드라이버는 pfnOfferAllocationsCb 를 호출하여 이전에 제출한 렌더링 작업을 완료한 후 다른 프로세스에서 사용할 할당의 메모리를 제공할 수 있음을 Microsoft DirectX 그래픽 커널 하위 시스템에 알립니다.
드라이버가 pfnOfferAllocationsCb 를 호출하여 다시 사용할 할당을 제공하면 할당을 잠그거나 렌더링 작업을 위해 제출하기 전에 pfnReclaimAllocationsCb 를 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |