PFN_GETDEVCFG (Windows Embedded CE 6.0)

1/5/2010

This function is used by KITL to get the device side KITL transport configuration information.

Syntax

BOOL TransportGetDevCfg(
  LPBYTE pbBuffer,
  PUSHORT pcbBuffer
);

Parameters

  • pbBuffer
    [in] Pointer to a buffer used to receive the data from the transport.
  • pcbBuffer
    [in] Set to the size of the buffer when called and then reset by the KITL transport to the size of data written to the pbBuffer buffer.

Return Value

Returns TRUE if data is added to the buffer; otherwise, returns FALSE.

If the transport has no device configuration information like a serial port, set pcbBuffer to 0 and return TRUE.

Remarks

You implement a function of this type and assign it to the pfnGetDevCfg member of the KITLTRANSPORT structure during your Board Support Package (BSP) KITL initialization. For an example of the implementation of this function, see the KitlEthGetDevCfg function in %_WINCEROOT%\Platform\Common\Src\Common\Kitl\Kitleth.c. If you are using the common KITL library in conjunction with Ethernet or serial transport, this function is already implemented for you.

For Ethernet transport, use EDBG_ADDR to provide the IP, MAC address, and port of the device.

For serial KITL, which is directly connected, TransportGetDevCfg is not required, but Kitl.dll must provide a stub function for it.

Requirements

Header kitl.h
Library Kitl.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Required KITL Functions
KITLTRANSPORT