USBCAMD_DriverEntry function (usbcamdi.h)

Article
02/22/2024

The USBCAMD_DriverEntry function registers the minidriver with USBCAMD, effectively binding USBCAMD and the minidriver together.

Syntax

ULONG USBCAMD_DriverEntry(
  [in] PVOID                           Context1,
  [in] PVOID                           Context2,
  [in] ULONG                           DeviceContextSize,
  [in] ULONG                           FrameCOntextSize,
  [in] PADAPTER_RECEIVE_PACKET_ROUTINE ReceivePacket
);

Parameters

[in] Context1

Pointer to the first argument that is passed to the camera minidriver's DriverEntry function. This is effectively a pointer to the driver object that is created by the system and passed to DriverEntry.

[in] Context2

Pointer to the second argument that is passed to the camera minidriver's DriverEntry function. This is effectively a pointer to the registry path that describes the minidriver's registry key.

[in] DeviceContextSize

Specifies the size, in bytes, required for the minidriver's device-specific context.

[in] FrameCOntextSize

Specifies the size, in bytes, required for the minidriver's frame-specific context structure. Use NULL if not needed.

[in] ReceivePacket

Pointer to the minidriver-defined AdapterReceivePacket function that handles adapter-based SRB requests.

Return value

USBCAMD_DriverEntry returns the status of the registration attempt. If a value other than STATUS_SUCCESS is returned, the minidriver is unloaded.

Remarks

A camera minidriver must call USBCAMD_DriverEntry from the minidriver's DriverEntry routine. For more information, see DriverEntry for Stream Class Minidrivers

FrameContextSize is optional. A non-NULL value should be provided only with calls to CamNewVideoFrame or CamProcessRawVideoFrame.

Requirements

Requirement	Value
Target Platform	Desktop
Header	usbcamdi.h (include Usbcamdi.h)
Library	Usbcamd2.lib