HSK Device Driver Interface for VxWorks* 5.4

C.6.1 RH_HSK_RH_PROCESS_PACKET

RH_HSK_RH_PROCESS_PACKET is called when a message packet is being redirected to a device driver for synchronization purposes. The RH driver validates the data packet header in addition to performing a CRC-16 check of the data payload. The payload part of the packet is driver dependent and defined by the driver developer. The RH driver confirms the validity of the CRC-16 value within the packet without validating packet contents.

Syntax

( UINT8* pBuf, int iLen, PVOID pContext )

Parameters

pBuf

Pointer to a data packet being received from the RH driver. It is the responsibility of the device driver to validate the packet contents. Upon returning from this callback, the RH driver deallocates the data packet. The data packet must be smaller than 1KB. The RH driver places no restrictions on the type of data used for two reasons:

The RH driver has no direct knowledge of the structure of this information

The RH driver is not required to perform any actions with this object

len

Length in bytes of the data packet being sent.

pContext

This parameter is a context value that is passed to the process packet function. This is a context free value, which means that the value is not modified by the message routing system, and is passed in its entirety.

Return Value

None

C.7 RH-Aware Send Message Definition

This section describes the syntax and functionality of the send message function.

C.7.1 HSI_STATUS rhHskSendMessage

This function initiates the sending of a data packet from a device driver on the Active Host to the corresponding device driver on the Redundant Host.

Syntax

(PRH_DATA_PACKET pPacket, UINT32 iLen, PCI_LOCATION pci )

Parameters

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

121

Page 121
Image 121
Intel ZT 4901 manual RH-Aware Send Message Definition, Hsistatus rhHskSendMessage, UINT8* pBuf, int iLen, Pvoid pContext