PFND3DDDI_OFFERALLOCATIONS2CB 콜백 함수(d3dumddi.h)

  • 아티클

재사용을 위해 비디오 메모리 할당을 제공하기 위해 사용자 모드 디스플레이 드라이버에서 호출됩니다.

구문

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}

매개 변수

hDevice

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다. Direct3D 런타임은 이 핸들을 디바이스를 만들 때 D3DDDIARG_CREATEDEVICE 구조의 hDevice 멤버로 사용자 모드 드라이버를 전달했습니다.

unnamedParam2

pData [in]

드라이버에서 제공하는 비디오 메모리 할당을 정의하는 D3DDDICB_OFFERALLOCATIONS2 구조체에 대한 포인터입니다.

반환 값

다음 값 중 하나를 반환합니다.

반환 코드 설명
S_OK 할당이 성공적으로 제공되었습니다.
참고: 드라이버가 pfnOfferAllocations2Cb 를 호출할 필요가 없는 경우 S_OK 반환해야 합니다.
D3DDDIERR_DEVICEREMOVED 플러그 앤 플레이(PnP) 중지 이벤트 또는 TDR(시간 제한 검색 및 복구) 이벤트가 발생했기 때문에 비디오 메모리 관리자 또는 디스플레이 미니포트 드라이버가 작업을 완료할 수 없습니다.
참고: 이 오류 코드가 반환되면 드라이버의 호출 함수(일반적으로 pfnOfferResources 루틴)는 이 오류 코드를 Direct3D 런타임에 반환해야 합니다.
E_INVALIDARG 잘못된 매개 변수가 제공되었습니다.

설명

사용자 모드 표시 드라이버는 pfnOfferAllocations2Cb 를 호출하여 이전에 제출한 렌더링 작업을 완료한 후 다른 프로세스에서 사용할 할당의 메모리를 제공할 수 있음을 Microsoft DirectX 그래픽 커널 하위 시스템에 알립니다.

드라이버가 pfnOfferAllocations2Cb 를 호출하여 다시 사용할 할당을 제공하면 할당을 잠그거나 렌더링 작업을 위해 제출하기 전에 pfnReclaimAllocations3Cb 를 호출해야 합니다.

pfnOfferAllocations2Cb 함수는 pData 매개 변수를 통해 플래그를 고려한다는 점을 제외하고 pfnOfferAllocationsCb와 동일하게 작동합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 d3dumddi.h(D3dumddi.h 포함)

추가 정보

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS2

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocations3Cb