VideoPortAllocateCommonBuffer 함수(video.h)

VideoPortAllocateCommonBuffer 함수는 공통 버퍼 DMA 작업을 위해 프로세서와 디바이스 모두에서 동시에 액세스할 수 있도록 시스템 메모리를 할당하고 매핑합니다.

구문

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN PVP_DMA_ADAPTER    VpDmaAdapter,
  [in]  IN ULONG              DesiredLength,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [in]  IN BOOLEAN            CacheEnabled,
  [out] OUT PVOID             Reserved
);

매개 변수

[in] HwDeviceExtension

미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

[in] VpDmaAdapter

버스 master 어댑터를 나타내는 VP_DMA_ADAPTER 구조체에 대한 포인터입니다. 이 구조체는 VideoPortGetDmaAdapter에 대한 이전 호출에서 반환되었습니다.

[in] DesiredLength

요청된 메모리 바이트 수를 지정합니다.

[out] LogicalAddress

어댑터가 할당된 버퍼에 액세스하는 데 사용할 논리 주소를 수신하는 메모리 위치에 대한 포인터입니다.

[in] CacheEnabled

할당된 메모리를 캐시할 수 있는지 여부를 지정합니다. 자세한 내용은 AllocateCommonBuffer에 대한 CacheEnabled 매개 변수에 대한 설명을 참조하세요.

[out] Reserved

현재 비디오 포트 드라이버에서 무시됩니다. 을 NULL로 설정해야 합니다.

반환 값

VideoPortAllocateCommonBuffer 는 성공한 경우 할당된 버퍼의 기본 가상 주소를 반환합니다. 그렇지 않으면 버퍼를 할당할 수 없는 경우 NULL 을 반환합니다.

설명

버퍼가 더 이상 필요하지 않은 경우 비디오 미니포트 드라이버는 VideoPortReleaseCommonBuffer를 호출하여 버퍼를 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	video.h(Video.h 포함)
라이브러리	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

추가 정보

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer