IOCTL_HAL_GET_IP_ADDR

This IOCTL supports retrieval of target device Ethernet address information. To retrieve target device Ethernet address information, 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

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.