IOCTL_HAL_GET_IP_ADDR (Windows CE 5.0)

  • Article

Send Feedback

This IOCTL supports retrieval of target device Ethernet address information. To retrieve Ethernet address information for a target device, call the OEMIoControl function with IOCTL_HAL_GET_IP_ADDR.

This IOCTL is no longer supported as of Windows CE .NET 4.0 and later.

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GET_IP_ADDR.

    Supports retrieval of target device Ethernet address information provided in the EDBG_ADDR structure.

  • lpInBuf
    [in] Pointer to the input buffer that can contain additional information associated with dwIoControlCode.

    If NULL, the value IPINFO_DOWNLOAD is assumed.

    Otherwise, lpInBuf should be a pointer to a DWORD, which can be one of the following values:

    • IPINFO_DEBUGMSG
    • IPINFO_KDEBUG
    • IPINFO_ESHELL
    • IPINFO_DOWNLOAD
    • Platform-specific extension

  • nInBufsize
    [in] Set to zero if lpInBuf is NULL; otherwise set to 4, which is the length of the lpInBufDWORD value.

  • lpOutBuf
    [out] Pointer to the output buffer supplied by the caller.

    The OAL should fill this buffer with an IP_INFO structure based on dwIoControlCode and lpInBuf into lpOutBuf, set lpBytesReturned to indicate the size of the IP_INFO structure, and return TRUE*.*

    If the size of the requested information exceeds the buffer size specified by nOutBufSize, call SetLastError with the ERROR_INSUFFICIENT_BUFFER flag and return the value FALSE.

  • nOutBufSize
    [in] Specifies the maximum number of bytes that can be returned in lpOutBuf.

    The caller sets this value.

  • lpBytesReturned
    [in] Number of bytes returned in lpOutBuf.

Return Values

TRUE indicates success. FALSE indicates failure.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Pkfuncs.h.

See Also

OEMIoControl | EDBG_ADDR

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.