www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - Packet Driver API


Set_WildcardAccess_Type

Installs an wildcard packet access Handler for Ethernet Packets.

unsigned int Set_WildcardAccess_Type ( Driver_Info *drv_info,
                                       void far * Receiver,
                                       int *pkt_type,
                                       int *handle );

Parameters

drv_info

Pointer to struct returned from Get_Driver_Info

Receiver

Pointer to receiver handler function

pkt_type

Pointer to pakcet type (e.g. 0xFFFF for accepting every ethernet packet)

handle

Pointer where handle should be stored (required for release type)

Return Value

0 on Success
else error code:
    0x00    NO_ERROR
    0x01    BAD_HANDLE        // invalid handle number
    0x05    BAD_TYPE          // Bad packet type specified
    0x09    NO_SPACE          // operation failed because of insufficient space
    0x0A    TYPE_INUSE        // the type had previously been accessed and not released
    0x0B    BAD_COMMAND       // the command was out of range, or not implemented
    0x0C    CANT_SEND         // the packet couldn't be sent (usually a hardware error)

Comments

Only one wildcard could be installed. Installing a new type overwrites the previous.
If a packettype of 0xFFFF is installed, any incoming packet will be accepted.
Delete a wild card handle by installing a wildcard with the packet type 0x0000.
"Normal" handlers installed with call are not overwritten by installing a wildcard

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3
    V1.00V1.00n/aV0.90

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document