PEXECUTE_DMA 콜백 함수(video.h)
HwVidExecuteDma 는 분산/수집 목록에서 물리적 주소/길이 쌍을 검색하고 하드웨어를 프로그래밍하여 실제 DMA 전송을 시작하는 미니포트 드라이버 구현 콜백 루틴입니다.
구문
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
매개 변수
HwDeviceExtension
미니포트 드라이버의 어댑터별 스토리지 영역에 대한 포인터입니다. 자세한 내용은 디바이스 확장을 참조하세요.
VpDmaAdapter
버스 master 어댑터를 나타내는 VP_DMA_ADAPTER 구조체에 대한 포인터입니다. 이 구조체는 VideoPortGetDmaAdapter를 호출하여 반환되었습니다.
SGList
VP_SCATTER_GATHER_LIST 구조체에 대한 포인터입니다. 비디오 포트 드라이버는 이 구조체의 정보를 채우고 이 구조를 미니포트 드라이버에 전달합니다.
Context
VideoPortStartDma에서 전달된 드라이버 결정 컨텍스트에 대한 포인터입니다.
반환 값
없음
설명
이 함수는 Windows XP 이상에서 사용할 수 있습니다.
미니포트 드라이버가 디바이스가 분산/수집을 지원하지 않는다고 보고하는 경우 이 루틴에 전달된 분산/수집 목록에는 단일 요소만 있습니다. 분산/수집 목록은 VideoPortCompleteDma 가 호출될 때까지 유효합니다.
비디오 포트 드라이버의 VideoPortStartDma 함수가 수행하는 마지막 작업은 미니포트 드라이버의 HwVidExecuteDma 콜백 루틴을 호출하는 것입니다. 실제로 DMA 전송 작업을 수행하는 것은 이 콜백입니다.
HwVidExecuteDma 는 페이지가 없는 메모리에 있어야 하며 페이징 가능한 코드 또는 데이터에 액세스해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | video.h(Video.h 포함) |