mirror of
https://github.com/reactos/reactos.git
synced 2024-08-27 13:48:42 +00:00
385 lines
9.9 KiB
C
385 lines
9.9 KiB
C
/*
|
|
* usbcamdi.h
|
|
*
|
|
* USB Camera driver interface.
|
|
*
|
|
* This file is part of the w32api package.
|
|
*
|
|
* Contributors:
|
|
* Created by Casper S. Hornstrup <chorns@users.sourceforge.net>
|
|
*
|
|
* THIS SOFTWARE IS NOT COPYRIGHTED
|
|
*
|
|
* This source code is offered for use in the public domain. You may
|
|
* use, modify or distribute it freely.
|
|
*
|
|
* This code is distributed in the hope that it will be useful but
|
|
* WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
|
|
* DISCLAIMED. This includes but is not limited to warranties of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
*
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if defined(_BATTERYCLASS_)
|
|
#define USBCAMAPI
|
|
#else
|
|
#define USBCAMAPI DECLSPEC_IMPORT
|
|
#endif
|
|
|
|
typedef struct _pipe_config_descriptor {
|
|
CHAR StreamAssociation;
|
|
UCHAR PipeConfigFlags;
|
|
} USBCAMD_Pipe_Config_Descriptor, *PUSBCAMD_Pipe_Config_Descriptor;
|
|
|
|
#define USBCAMD_DATA_PIPE 0x0001
|
|
#define USBCAMD_MULTIPLEX_PIPE 0x0002
|
|
#define USBCAMD_SYNC_PIPE 0x0004
|
|
#define USBCAMD_DONT_CARE_PIPE 0x0008
|
|
|
|
#define USBCAMD_VIDEO_STREAM 0x1
|
|
#define USBCAMD_STILL_STREAM 0x2
|
|
#define USBCAMD_VIDEO_STILL_STREAM (USBCAMD_VIDEO_STREAM | USBCAMD_STILL_STREAM)
|
|
|
|
#define USBCAMD_PROCESSPACKETEX_DropFrame 0x0002
|
|
#define USBCAMD_PROCESSPACKETEX_NextFrameIsStill 0x0004
|
|
#define USBCAMD_PROCESSPACKETEX_CurrentFrameIsStill 0x0008
|
|
|
|
#define USBCAMD_STOP_STREAM 0x00000001
|
|
#define USBCAMD_START_STREAM 0x00000000
|
|
|
|
typedef enum {
|
|
USBCAMD_CamControlFlag_NoVideoRawProcessing = 1,
|
|
USBCAMD_CamControlFlag_NoStillRawProcessing = 2,
|
|
USBCAMD_CamControlFlag_AssociatedFormat = 4,
|
|
USBCAMD_CamControlFlag_EnableDeviceEvents = 8
|
|
} USBCAMD_CamControlFlags;
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCOMMAND_COMPLETE_FUNCTION)(
|
|
IN PVOID DeviceContext,
|
|
IN OUT PVOID CommandContext,
|
|
IN NTSTATUS NtStatus);
|
|
|
|
typedef VOID
|
|
(NTAPI *PSTREAM_RECEIVE_PACKET)(
|
|
IN PVOID Srb,
|
|
IN PVOID DeviceContext,
|
|
IN PBOOLEAN Completed);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_INITIALIZE_ROUTINE)(
|
|
PDEVICE_OBJECT BusDeviceObject,
|
|
PVOID DeviceContext);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_CONFIGURE_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PUSBD_INTERFACE_INFORMATION Interface,
|
|
IN PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
|
|
IN PLONG DataPipeIndex,
|
|
IN PLONG SyncPipeIndex);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_CONFIGURE_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PUSBD_INTERFACE_INFORMATION Interface,
|
|
IN PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
|
|
IN ULONG PipeConfigListSize,
|
|
IN PUSBCAMD_Pipe_Config_Descriptor PipeConfig,
|
|
IN PUSB_DEVICE_DESCRIPTOR DeviceDescriptor);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_START_CAPTURE_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_START_CAPTURE_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN ULONG StreamNumber);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_ALLOCATE_BW_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PULONG RawFrameLength,
|
|
IN PVOID Format);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_ALLOCATE_BW_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PULONG RawFrameLength,
|
|
IN PVOID Format,
|
|
IN ULONG StreamNumber);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_FREE_BW_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_FREE_BW_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN ULONG StreamNumber);
|
|
|
|
typedef VOID
|
|
(NTAPI *PADAPTER_RECEIVE_PACKET_ROUTINE)(
|
|
IN OUT PHW_STREAM_REQUEST_BLOCK Srb);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_STOP_CAPTURE_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_STOP_CAPTURE_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN ULONG StreamNumber);
|
|
|
|
typedef ULONG
|
|
(NTAPI *PCAM_PROCESS_PACKET_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PVOID CurrentFrameContext,
|
|
IN PUSBD_ISO_PACKET_DESCRIPTOR SyncPacket OPTIONAL,
|
|
IN PVOID SyncBuffer OPTIONAL,
|
|
IN PUSBD_ISO_PACKET_DESCRIPTOR DataPacket OPTIONAL,
|
|
IN OUT PVOID DataBuffer,
|
|
OUT PBOOLEAN FrameComplete,
|
|
OUT PBOOLEAN NextFrameIsStill);
|
|
|
|
typedef ULONG
|
|
(NTAPI *PCAM_PROCESS_PACKET_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PVOID CurrentFrameContext,
|
|
IN PUSBD_ISO_PACKET_DESCRIPTOR SyncPacket OPTIONAL,
|
|
IN PVOID SyncBuffer OPTIONAL,
|
|
IN PUSBD_ISO_PACKET_DESCRIPTOR DataPacket OPTIONAL,
|
|
IN OUT PVOID DataBuffer,
|
|
OUT PBOOLEAN FrameComplete,
|
|
OUT PULONG PacketFlag,
|
|
OUT PULONG ValidDataOffset);
|
|
|
|
typedef VOID
|
|
(NTAPI *PCAM_NEW_FRAME_ROUTINE)(
|
|
IN PVOID DeviceContext,
|
|
IN PVOID FrameContext);
|
|
|
|
typedef VOID
|
|
(NTAPI *PCAM_NEW_FRAME_ROUTINE_EX)(
|
|
IN PVOID DeviceContext,
|
|
IN PVOID FrameContext,
|
|
IN ULONG StreamNumber,
|
|
OUT PULONG FrameLength);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_PROCESS_RAW_FRAME_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PVOID FrameContext,
|
|
IN PVOID FrameBuffer,
|
|
IN ULONG FrameLength,
|
|
OUT PVOID RawFrameBuffer,
|
|
IN ULONG RawFrameLength,
|
|
IN ULONG NumberOfPackets,
|
|
OUT PULONG BytesReturned);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_PROCESS_RAW_FRAME_ROUTINE_EX)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext,
|
|
IN PVOID FrameContext,
|
|
IN PVOID FrameBuffer,
|
|
IN ULONG FrameLength,
|
|
OUT PVOID RawFrameBuffer,
|
|
IN ULONG RawFrameLength,
|
|
IN ULONG NumberOfPackets,
|
|
OUT PULONG BytesReturned,
|
|
IN ULONG ActualRawFrameLength,
|
|
IN ULONG StreamNumber);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PCAM_STATE_ROUTINE)(
|
|
IN PDEVICE_OBJECT BusDeviceObject,
|
|
IN PVOID DeviceContext);
|
|
|
|
#if defined(DEBUG_LOG)
|
|
|
|
USBCAMAPI
|
|
VOID
|
|
NTAPI
|
|
USBCAMD_Debug_LogEntry(
|
|
IN CHAR *Name,
|
|
IN ULONG Info1,
|
|
IN ULONG Info2,
|
|
IN ULONG Info3);
|
|
|
|
#define ILOGENTRY(sig, info1, info2, info3) \
|
|
USBCAMD_Debug_LogEntry(sig, (ULONG)info1, (ULONG)info2, (ULONG)info3)
|
|
|
|
#else
|
|
|
|
#define ILOGENTRY(sig, info1, info2, info3)
|
|
|
|
#endif /* DEBUG_LOG */
|
|
|
|
typedef struct _USBCAMD_DEVICE_DATA {
|
|
ULONG Sig;
|
|
PCAM_INITIALIZE_ROUTINE CamInitialize;
|
|
PCAM_INITIALIZE_ROUTINE CamUnInitialize;
|
|
PCAM_PROCESS_PACKET_ROUTINE CamProcessUSBPacket;
|
|
PCAM_NEW_FRAME_ROUTINE CamNewVideoFrame;
|
|
PCAM_PROCESS_RAW_FRAME_ROUTINE CamProcessRawVideoFrame;
|
|
PCAM_START_CAPTURE_ROUTINE CamStartCapture;
|
|
PCAM_STOP_CAPTURE_ROUTINE CamStopCapture;
|
|
PCAM_CONFIGURE_ROUTINE CamConfigure;
|
|
PCAM_STATE_ROUTINE CamSaveState;
|
|
PCAM_STATE_ROUTINE CamRestoreState;
|
|
PCAM_ALLOCATE_BW_ROUTINE CamAllocateBandwidth;
|
|
PCAM_FREE_BW_ROUTINE CamFreeBandwidth;
|
|
} USBCAMD_DEVICE_DATA, *PUSBCAMD_DEVICE_DATA;
|
|
|
|
typedef struct _USBCAMD_DEVICE_DATA2 {
|
|
ULONG Sig;
|
|
PCAM_INITIALIZE_ROUTINE CamInitialize;
|
|
PCAM_INITIALIZE_ROUTINE CamUnInitialize;
|
|
PCAM_PROCESS_PACKET_ROUTINE_EX CamProcessUSBPacketEx;
|
|
PCAM_NEW_FRAME_ROUTINE_EX CamNewVideoFrameEx;
|
|
PCAM_PROCESS_RAW_FRAME_ROUTINE_EX CamProcessRawVideoFrameEx;
|
|
PCAM_START_CAPTURE_ROUTINE_EX CamStartCaptureEx;
|
|
PCAM_STOP_CAPTURE_ROUTINE_EX CamStopCaptureEx;
|
|
PCAM_CONFIGURE_ROUTINE_EX CamConfigureEx;
|
|
PCAM_STATE_ROUTINE CamSaveState;
|
|
PCAM_STATE_ROUTINE CamRestoreState;
|
|
PCAM_ALLOCATE_BW_ROUTINE_EX CamAllocateBandwidthEx;
|
|
PCAM_FREE_BW_ROUTINE_EX CamFreeBandwidthEx;
|
|
} USBCAMD_DEVICE_DATA2, *PUSBCAMD_DEVICE_DATA2;
|
|
|
|
DEFINE_GUID(GUID_USBCAMD_INTERFACE,
|
|
0x2bcb75c0, 0xb27f, 0x11d1, 0xba, 0x41, 0x0, 0xa0, 0xc9, 0xd, 0x2b, 0x5);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PFNUSBCAMD_SetVideoFormat)(
|
|
IN PVOID DeviceContext,
|
|
IN PHW_STREAM_REQUEST_BLOCK pSrb);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PFNUSBCAMD_WaitOnDeviceEvent)(
|
|
IN PVOID DeviceContext,
|
|
IN ULONG PipeIndex,
|
|
IN PVOID Buffer,
|
|
IN ULONG BufferLength,
|
|
IN PCOMMAND_COMPLETE_FUNCTION EventComplete,
|
|
IN PVOID EventContext,
|
|
IN BOOLEAN LoopBack);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PFNUSBCAMD_CancelBulkReadWrite)(
|
|
IN PVOID DeviceContext,
|
|
IN ULONG PipeIndex);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PFNUSBCAMD_SetIsoPipeState)(
|
|
IN PVOID DeviceContext,
|
|
IN ULONG PipeStateFlags);
|
|
|
|
typedef NTSTATUS
|
|
(NTAPI *PFNUSBCAMD_BulkReadWrite)(
|
|
IN PVOID DeviceContext,
|
|
IN USHORT PipeIndex,
|
|
IN PVOID Buffer,
|
|
IN ULONG BufferLength,
|
|
IN PCOMMAND_COMPLETE_FUNCTION CommandComplete,
|
|
IN PVOID CommandContext);
|
|
|
|
#define USBCAMD_VERSION_200 0x200
|
|
|
|
typedef struct _USBCAMD_INTERFACE {
|
|
INTERFACE Interface;
|
|
PFNUSBCAMD_WaitOnDeviceEvent USBCAMD_WaitOnDeviceEvent;
|
|
PFNUSBCAMD_BulkReadWrite USBCAMD_BulkReadWrite;
|
|
PFNUSBCAMD_SetVideoFormat USBCAMD_SetVideoFormat;
|
|
PFNUSBCAMD_SetIsoPipeState USBCAMD_SetIsoPipeState;
|
|
PFNUSBCAMD_CancelBulkReadWrite USBCAMD_CancelBulkReadWrite;
|
|
} USBCAMD_INTERFACE, *PUSBCAMD_INTERFACE;
|
|
|
|
/* FIXME : Do we need USBCAMAPI here ? */
|
|
|
|
USBCAMAPI
|
|
ULONG
|
|
NTAPI
|
|
USBCAMD_DriverEntry(
|
|
IN PVOID Context1,
|
|
IN PVOID Context2,
|
|
IN ULONG DeviceContextSize,
|
|
IN ULONG FrameContextSize,
|
|
IN PADAPTER_RECEIVE_PACKET_ROUTINE ReceivePacket);
|
|
|
|
USBCAMAPI
|
|
PVOID
|
|
NTAPI
|
|
USBCAMD_AdapterReceivePacket(
|
|
IN PHW_STREAM_REQUEST_BLOCK Srb,
|
|
IN PUSBCAMD_DEVICE_DATA DeviceData,
|
|
IN PDEVICE_OBJECT *DeviceObject,
|
|
IN BOOLEAN NeedsCompletion);
|
|
|
|
USBCAMAPI
|
|
NTSTATUS
|
|
NTAPI
|
|
USBCAMD_ControlVendorCommand(
|
|
IN PVOID DeviceContext,
|
|
IN UCHAR Request,
|
|
IN USHORT Value,
|
|
IN USHORT Index,
|
|
IN OUT PVOID Buffer,
|
|
IN OUT PULONG BufferLength,
|
|
IN BOOLEAN GetData,
|
|
IN PCOMMAND_COMPLETE_FUNCTION CommandComplete OPTIONAL,
|
|
IN PVOID CommandContext OPTIONAL);
|
|
|
|
USBCAMAPI
|
|
NTSTATUS
|
|
NTAPI
|
|
USBCAMD_SelectAlternateInterface(
|
|
IN PVOID DeviceContext,
|
|
IN OUT PUSBD_INTERFACE_INFORMATION RequestInterface);
|
|
|
|
USBCAMAPI
|
|
NTSTATUS
|
|
NTAPI
|
|
USBCAMD_GetRegistryKeyValue(
|
|
IN HANDLE Handle,
|
|
IN PWCHAR KeyNameString,
|
|
IN ULONG KeyNameStringLength,
|
|
IN PVOID Data,
|
|
IN ULONG DataLength);
|
|
|
|
USBCAMAPI
|
|
ULONG
|
|
NTAPI
|
|
USBCAMD_InitializeNewInterface(
|
|
IN PVOID DeviceContext,
|
|
IN PVOID DeviceData,
|
|
IN ULONG Version,
|
|
IN ULONG CamControlFlag);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* !defined(__USB_H) && !defined(__USBDI_H) */
|