PCAM_PROCESS_PACKET_ROUTINE 콜백 함수(usbcamdi.h)

[CamProcessUSBPacket은 지원되지 않으며 나중에 변경되거나 사용할 수 없습니다. 대신 CamProcessUSBPacketEx를 사용합니다. ]

카메라 미니드라이버의 CamProcessUSBPacket 콜백 함수는 USB 패킷을 처리합니다.

구문

PCAM_PROCESS_PACKET_ROUTINE PcamProcessPacketRoutine;

ULONG PcamProcessPacketRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PVOID CurrentFrameContext,
  PUSBD_ISO_PACKET_DESCRIPTOR SyncPacket,
  PVOID SyncBuffer,
  PUSBD_ISO_PACKET_DESCRIPTOR DataPacket,
  PVOID DataBuffer,
  PBOOLEAN FrameComplete,
  PBOOLEAN NextFrameIsStill
)
{...}

매개 변수

BusDeviceObject

USB 허브에서 만든 카메라 미니드라이버의 디바이스 개체에 대한 포인터입니다.

DeviceContext

카메라 미니 드라이버의 디바이스 컨텍스트에 대한 포인터입니다.

CurrentFrameContext

미니 드라이버의 프레임 컨텍스트에 대한 포인터입니다.

SyncPacket

동기화 파이프의 USBD_ISO_PACKET_DESCRIPTOR 구조체에 대한 포인터입니다. 인터페이스에 파이프가 하나만 있는 경우 이 값은 NULL 입니다.

SyncBuffer

SyncPacket의 데이터에 대한 포인터입니다.

DataPacket

데이터 파이프의 USBD_ISO_PACKET_DESCRIPTOR 구조체에 대한 포인터입니다.

DataBuffer

DataPacket에 대한 포인터입니다.

FrameComplete

카메라 미니드라이버가 새 비디오 프레임의 첫 번째 데이터 패킷인지 여부를 나타내기 위해 설정하는 BOOLEAN 값에 대한 포인터입니다. 새 비디오 프레임의 첫 번째 데이터 패킷인 경우 TRUE 로 설정합니다.

NextFrameIsStill

카메라 미니드라이버가 다음 프레임이 스틸 프레임인지 여부를 나타내기 위해 설정하는 BOOLEAN 값에 대한 포인터입니다. 비디오 스트림이 라이브 이미지를 제공하는 경우 이 값을 FALSE 로 설정하거나 다음 프레임이 스틸 이미지 또는 이미지 캡처 스트림인 경우 TRUE 로 설정해야 합니다.

반환 값

이 콜백 함수는 버퍼(RawFrameBuffer 또는 FrameBuffer)에 복사해야 하는 바이트 수를 나타내는 ULONG을 반환합니다.

설명

원래 USBCAMD와 이전 버전과의 호환성을 유지해야 하는 카메라 미니드라이버에서는 USBCAMD_DEVICE_DATA 구조와 연결된 콜백 함수(즉, "Ex" 접미사가 포함되지 않은 콜백 함수)를 사용해야 합니다.

미니드라이버가 이 함수를 최대한 빨리 완료해야 합니다. 이미지 처리는 CamProcessRawVideoFrame 함수로 지연되어야 합니다.

이 함수는 선택 사항입니다.

요구 사항

추가 정보

CamProcessRawVideoFrame

CamProcessUSBPacketEx

USBD_ISO_PACKET_DESCRIPTOR