DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA 콜백 함수(d3dkmddi.h)

DxgkDdiGetStandardAllocationDriverData 함수는 표준 할당 형식에 대한 설명을 반환합니다.

구문

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in/out] pGetStandardAllocationDriverData

표준 할당을 설명하는 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 구조체에 대한 포인터입니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS DxgkDdiGetStandardAllocationDriverData는 표준 할당 형식에 대한 설명을 반환했습니다.
STATUS_NO_MEMORY DxgkDdiGetStandardAllocationDriverData가 완료하는 데 필요한 메모리를 할당할 수 없습니다.

설명

표준 할당 유형 은 사용자 모드 표시 드라이버와 통신하지 않고 커널 모드로 만들어야 하는 할당입니다. DirectX 그래픽 커널 하위 시스템은 DxgkDdiGetStandardAllocationDriverData 함수를 호출하여 pGetStandardAllocationDriverData 매개 변수가 지정하는 표준 할당 형식에 대한 설명을 생성합니다. 디스플레이 미니포트 드라이버는 pGetStandardAllocationDriverData 매개 변수가 가리키는 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 구조체의 pAllocationPrivateDriverDatapResourcePrivateDriverData 멤버의 할당 형식에 대한 설명을 반환합니다. DirectX 그래픽 커널 하위 시스템은 나중에 DxgkDdiCreateAllocation 함수에 설명을 전달하여 실제로 할당을 만듭니다.

Windows 7부터 디스플레이 미니포트 드라이버가 DxgkDdiGetStandardAllocationDriverData 함수에 대한 호출을 처리하여 GDI 하드웨어 가속에 대한 할당을 만드는 경우 드라이버는 CPU 표시 할당인 pGetStandardAllocationDriverData->pCreateGdiSurfaceDataPitch->에 대한 할당 피치를 설정해야 합니다.

DxgkDdiGetStandardAllocationDriverData 를 페이징 가능으로 만들어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 d3dkmddi.h
IRQL PASSIVE_LEVEL

참고 항목

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation