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 는 다음을 수행해야 합니다.

  1. VRP의 IoControlCode 멤버를 확인하여 디스플레이 드라이버가 요청하는 작업을 확인합니다.
  2. VRP InputBufferLength 및/또는 OutputBufferLength 가 요청을 충족할 수 있을 만큼 큰 버퍼를 나타내는지 확인합니다. 버퍼가 너무 작은 경우 미니포트 드라이버는 오류를 반환해야 합니다.
  3. 요청을 충족합니다.
  4. VRP에서 상태 및 정보 멤버를 설정하고 TRUE를 반환합니다.
시스템 비디오 포트 드라이버는 모든 요청을 직렬화합니다. 미니포트 드라이버는 HwVidInterrupt 함수가 없는 한 자체 직렬화를 수행할 필요가 없습니다.

그러나 모든 미니포트 드라이버의 HwVidStartIO 함수는 요청된 각 작업을 완료하거나 VRP의 StatusBlock 에서 컨트롤을 반환하기 전에 적절한 오류를 설정해야 합니다.

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

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 video.h(Video.h 포함)

추가 정보

VIDEO_REQUEST_PACKET

비디오 미니포트 드라이버 I/O 제어 코드

VideoPortSynchronizeExecution