VhfReadReportSubmit 함수(vhf.h)

HID 소스 드라이버는 이 메서드를 호출하여 HID 읽기(입력) 보고서를 VHF(Virtual HID Framework)에 제출합니다.

통사론

NTSTATUS VhfReadReportSubmit(
  [in] VHFHANDLE        VhfHandle,
  [in] PHID_XFER_PACKET HidTransferPacket
);

매개 변수

[in] VhfHandle

VhfCreate대한 이전 호출에서 HID 원본 드라이버가 받은 가상 HID 디바이스에 대한 핸들입니다.

[in] HidTransferPacket

HID 보고서를 설명하는 HID_XFER_PACKET 구조체에 대한 포인터입니다.

반환 값

VhfReadReportSubmit 호출이 성공하면 메서드는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 값입니다.

발언

HID 원본 드라이버는 버퍼링 정책을 구현하거나 VHF(Virtual HID Framework)에서 버퍼링을 처리하도록 선택할 수 있습니다.

드라이버가 자체 버퍼링 정책을 사용하는 경우 VhfCreate호출에서 EvtVhfReadyForNextReadReport 콜백 함수를 구현하고 등록해야 합니다. VHF가 EvtVhfReadyForNextReadReport호출한 후에는 VhfReadReportSubmit 한 번만 호출해야 합니다. 콜백이 호출된 후 드라이버는 HidTransferPacket가리키는 전송 버퍼를 다시 사용할 수 있습니다. 드라이버는 이 메서드를 다시 호출하기 전에 다음에 VHF가 EvtVhfReadyForNextReadReport 호출할 때까지 기다려야 합니다.

HID 원본 드라이버가 EvtVhfReadyForNextReadReport 콜백을 구현하지 않는 경우 이 메서드를 호출하는 데 제한이 없습니다. VHF는 기본 버퍼링 정책을 사용합니다. 드라이버는 호출이 반환된 후 전송 버퍼를 다시 사용할 수 있습니다.

요구 사항

요구	값
대상 플랫폼	Windows
헤더	vhf.h
라이브러리	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

참고 항목

VHF(Virtual HID Framework) 사용하여 HID 원본 드라이버 작성