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 ;如果下一個畫面是仍然影像或影像擷取數據流,則此值應設定為 FALSE 。
傳回值
這個回呼函式會傳回 ULONG,指出應該複製到緩衝區的位元元組數目, (RawFrameBuffer 或 FrameBuffer) 。
備註
必須維持與原始 USBCAMD 回溯相容性的相機迷你驅動程式必須使用 USBCAMD_DEVICE_DATA 結構及其相關聯的回呼函式, (也就是不包含 “Ex” 後綴的回呼函式) 。
迷你驅動程式應該儘快完成此函式。 影像處理應延後至 CamProcessRawVideoFrame 函式。
此函式是選擇性的。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | usbcamdi.h (包含 Usbcamdi.h) |
IRQL | DISPATCH_LEVEL |