IMAQdxRegisterPnpEvent

NI-IMAQdx Function Reference

previous page next page

IMAQdxRegisterPnpEvent

Format

rval = IMAQdxRegisterPnpEvent (IMAQdxSession id, IMAQdxPnpEvent event, PnpEventCallbackPtr callbackFunction, void *callbackData);

Purpose

Configures the NI-IMAQdx driver to execute a callback function when a plug and play event occurs.

Note  Make sure that the code inside the callback is thread safe since the callback executes in a different thread.

Parameters

Parameter Type Description
id IMAQdxSession A valid Session ID, which you can obtain using IMAQdxOpenCamera.
event IMAQdxPnpEvent The plug and play event to monitor. The following events are valid:

  • IMAQdxPnpEventCameraAttached: Callback fired when a new camera is attached.

  • IMAQdxPnpEventCameraDetached: Callback fired when the camera is detached.

  • IMAQdxPnpEventBusReset: Callback fired when a FireWire bus reset occurs.
callbackFunction PnpEventCallbackPtr The address of the callback function.
callback Data void * A pointer to user-defined data passed to the event function.

Return Value

On success, this function returns IMAQdxErrorSuccess. On failure, this function returns an error code. You can obtain a more detailed error message with IMAQdxGetErrorString.

previous page start next page