PVIDEO_HW_START_IO 콜백 함수(video.h)
HwVidStartIO 는 지정된 VRP를 처리합니다.
구문
PVIDEO_HW_START_IO PvideoHwStartIo;
BOOLEAN PvideoHwStartIo(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET RequestPacket
)
{...}
매개 변수
HwDeviceExtension
미니포트 드라이버의 어댑터별 스토리지 영역에 대한 포인터입니다. 자세한 내용은 디바이스 확장을 참조하세요.
RequestPacket
EngDeviceIoControl에 원래 전달된 모든 매개 변수를 포함하는 VIDEO_REQUEST_PACKET 구조체에 대한 포인터입니다.
반환 값
HwVidStartIO 는 요청을 완료했음을 나타내는 TRUE를 반환해야 합니다.
설명
모든 비디오 미니포트 드라이버에는 HwVidStartIO 함수가 있어야 합니다.
비디오 포트 드라이버는 해당 디스플레이 드라이버에서 시작되는 각 GDI EngDeviceIoControl 요청에 대한 응답으로 HwVidStartIO를 호출합니다. HwVidStartIO가 호출되면 미니포트 드라이버는 요청된 작업을 완료할 때까지 입력 비디오 요청 패킷을 소유합니다. HwVidStartIO 는 다음을 수행해야 합니다.
- VRP의 IoControlCode 멤버를 확인하여 디스플레이 드라이버가 요청하는 작업을 확인합니다.
- VRP InputBufferLength 및/또는 OutputBufferLength 가 요청을 충족할 수 있을 만큼 큰 버퍼를 나타내는지 확인합니다. 버퍼가 너무 작은 경우 미니포트 드라이버는 오류를 반환해야 합니다.
- 요청을 충족합니다.
- VRP에서 상태 및 정보 멤버를 설정하고 TRUE를 반환합니다.
그러나 모든 미니포트 드라이버의 HwVidStartIO 함수는 요청된 각 작업을 완료하거나 VRP의 StatusBlock 에서 컨트롤을 반환하기 전에 적절한 오류를 설정해야 합니다.
HwVidStartIO를 페이징 가능으로 만들어야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | video.h(Video.h 포함) |