Partager via

IOCTL_HAL_GET_IP_ADDR (Windows Embedded CE 6.0)

  • Article

1/5/2010

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

Header pkfuncs.h
Windows Embedded CE Windows CE 3.0 and later

See Also

Reference

Other OAL IOCTLs
OEMIoControl
EDBG_ADDR