xApplicationDHCPHook()

[FreeRTOS-Plus-TCP API 引用]

注意：仅当 ipconfigUSE_DHCP_HOOK 在 FreeRTOSIPConfig.h 文件中设置为 1 时才需要定义此钩子。

eDHCPCallbackAnswer_t xApplicationDHCPHook( eDHCPCallbackPhase_t eDHCPPhase,uint32_t ulIPAddress );
        

xApplicationDHCPHook 是由 FreeRTOS-Plus-TCP 堆栈调用的钩子（或称回调）函数，用于 检查是否应发送 DHCP “发现”和“请求”消息以完成获取动态 IP 地址的流程， 或检查设备是否使用了默认静态 IP。

回调函数由应用程序编写器实现，但由 TCP/IP 堆栈调用。回调函数的原型 必须与上面的原型完全匹配（包括函数名称）。应用程序钩子中的代码不应调用正被阻塞的 FreeRTOS-Plus-TCP API 。这样很容易导致死锁。

当应用程序钩子执行时，会借用任务优先级和 IP 任务堆栈。因此，我们建议您保持应用程序钩子的简短性——它可能需要唤醒一些负责执行进一步处理的应用程序任务。

参数：

返回值可为以下枚举值：

• 如果应用程序想要继续 DHCP 事务，返回 eDHCPContinue。
• 如果应用程序想要使用默认网络参数，返回 eDHCPUseDefaults。
• 在必须中止 DHCP 进程且所有网络参数保持不变的情况下，返回 eDHCPStopNoChanges 。