Sends a raw buffer to a CG board.
DWORD oamSendBuffer ( CTAHD ctahd, const char *szName, const BYTE *pbBuf, DWORD dwBufLen )
|
Argument |
Description |
|
ctahd |
[in] Context handle. |
|
szName |
[in] Pointer to the name of board to which to send the buffer. |
|
pbBuf |
[in] Pointer to buffer to send. |
|
dwBufLen |
[in] Size of pbBuf. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
szName or pbBuf is NULL or 0. |
|
CTAERR_SVR_COMM |
Natural Access Server is not running. |
|
OAMERR_NOT_FOUND |
Board szName not found. |
|
OAMERR_SERVER_NOT_RUNNING |
Supervisor is shut down. |
oamSendBuffer is an advanced function. Sending data using this method can place the board in an indeterminate state, or can cause the resource host to malfunction in other ways. This functionality is provided mainly for plug-in developers, to permit easy low-level debugging. To use this function, contact NMS technical services.
CG boards must be started before you invoke oamSendBuffer.
To send a raw buffer of data to a board, construct the buffer and invoke oamSendBuffer, passing the name of the target board and a pointer to the data buffer in the function invocation. In addition to the return values previously listed, this function can return board type-specific values. For information about possible board errors, see the board-specific documentation.