UEFI 模块中的“指针传递约定”答案

【问题标题】："pointer passing convention" in UEFI moduleUEFI 模块中的“指针传递约定”
【发布时间】：2020-06-30 19:38:39
【问题描述】：

我想知道何时需要释放从 EFI 函数返回的指针

EFI_DEVICE_PATH_PROTOCOL *
BmExpandFileDevicePath (
  IN  EFI_DEVICE_PATH_PROTOCOL    *FilePath,
  IN  EFI_DEVICE_PATH_PROTOCOL    *FullPath
  )
{
  EFI_STATUS                      Status;
  UINTN                           Index;
  UINTN                           HandleCount;
  EFI_HANDLE                      *Handles;
  EFI_BLOCK_IO_PROTOCOL           *BlockIo;
  UINTN                           MediaType;
  EFI_DEVICE_PATH_PROTOCOL        *NextFullPath;
  BOOLEAN                         GetNext;

  EfiBootManagerConnectAll ();
  Status = gBS->LocateHandleBuffer (ByProtocol, &gEfiSimpleFileSystemProtocolGuid, NULL, &HandleCount, &Handles);
  if (EFI_ERROR (Status)) {
    HandleCount = 0;
    Handles = NULL;
  }

  GetNext = (BOOLEAN)(FullPath == NULL);
  NextFullPath = NULL;
  //
  // Enumerate all removable media devices followed by all fixed media devices,
  //   followed by media devices which don't layer on block io.
  //
  for (MediaType = 0; MediaType < 3; MediaType++) {
    for (Index = 0; Index < HandleCount; Index++) {
      Status = gBS->HandleProtocol (Handles[Index], &gEfiBlockIoProtocolGuid, (VOID *) &BlockIo);
      if (EFI_ERROR (Status)) {
        BlockIo = NULL;
      }
      if ((MediaType == 0 && BlockIo != NULL && BlockIo->Media->RemovableMedia) ||
          (MediaType == 1 && BlockIo != NULL && !BlockIo->Media->RemovableMedia) ||
          (MediaType == 2 && BlockIo == NULL)
          ) {
        NextFullPath = AppendDevicePath (DevicePathFromHandle (Handles[Index]), FilePath);
        if (GetNext) {
          break;
        } else {
          GetNext = (BOOLEAN)(CompareMem (NextFullPath, FullPath, GetDevicePathSize (NextFullPath)) == 0);
          FreePool (NextFullPath);
          NextFullPath = NULL;
        }
      }
    }
    if (NextFullPath != NULL) {
      break;
    }
  }

  if (Handles != NULL) {
    FreePool (Handles);
  }

  return NextFullPath;
}

例如，在这段代码中，我可以在调用HandleProtocol 后释放Handles 并且仍然可以使用BlockIo 吗？是否有解释 edk2 函数的“指针传递约定”的文档？谢谢。

【问题讨论】：

标签： c uefi

【解决方案1】：

您必须查看specification，如果您负责释放指针，则有注释。

对于您的 LocateHandleBuffer 示例：

缓冲区

指向缓冲区的指针以返回请求的句柄数组支持协议。该缓冲区是通过调用 Boot 分配的服务 EFI_BOOT_SERVICES.AllocatePool()。 这是调用者的负责调用引导服务 EFI_BOOT_SERVICES.FreePool() 当调用者不再需要 Buffer 的内容时。”

您可以在释放缓冲区后使用 BlockIO 协议，而不是释放句柄实例（这将是一个非常糟糕的主意），而是释放它们的数组。

【讨论】：