DeviceCloseFunc

BOOLEAN
DeviceCloseFunc(
PDEVICE_INFO
pDevInfo
);

The DeviceCloseFunc function performs operations that must be completed when a video capture device is closed. The function is provided by the kernel-mode driver, and the DeviceCloseFunc name is a placeholder for a driver-specified function name.

Parameters

pDevInfo

Pointer to the DEVICE_INFO structure returned by VC_Init.

Return Value

Returns TRUE if the operation succeeds. Otherwise returns FALSE. If FALSE, VCKernel.lib sets the Win32 error code value to STATUS_DRIVER_INTERNAL_ERROR.

Coments

The VCKernel.lib library calls the kernel-mode driver's DeviceCloseFunc function when it receives an IRP_MJ_CLOSE function code, which indicates the client is closing the device. The DeviceCloseFunc function might disable hardware and deallocate memory space that the driver allocated when the device was opened.

Support for a DeviceCloseFunc function is optional. If a driver does support the function, it must place its address in the VC_CALLBACK structure supplied by VCKernel.lib.

See Also

CleanupFunc