PCAM_STOP_CAPTURE_ROUTINE callback function (usbcamdi.h)

Article
02/22/2024

[CamStopCapture is not supported and may be altered or unavailable in the future. Instead, use CamStopCaptureEx. ]

A camera minidriver's CamStopCapture callback function performs any processing after the stream is stopped.

Syntax

PCAM_STOP_CAPTURE_ROUTINE PcamStopCaptureRoutine;

NTSTATUS PcamStopCaptureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext
)
{...}

Parameters

BusDeviceObject

Pointer to the camera minidriver's device object created by the USB hub.

DeviceContext

Pointer to the camera minidriver's device context.

Return value

CamStopCapture returns STATUS_SUCCESS or an appropriate error code. This return value is the completion code for the read IRP.

Remarks

Camera minidrivers that must maintain backward compatibility with the original USBCAMD must use the USBCAMD_DEVICE_DATA structure and its associated callback functions (that is, callback functions that do not contain the "Ex" suffix).

USBCAMD calls the minidriver's CamStopCapture callback function immediately after the isochronous video stream is stopped. Typically, a camera minidriver selects an alternate setting within the USB video streaming interface that uses no additional bandwidth.

This function is required.

Requirements

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