9. ProtocolsPerHandle API를 통한 ImageHandle 프로토콜 가져오기
API를 통해서 간편하게 ImageHandle 프로토콜 가져오기
이전 장에서 설명한 이미지 핸들에 대한 프로토콜을 찾는 방식은 단순히 구조를 이해하기 위해서다. 동일한 결과를 UEFI API를 사용하면 더욱 간편하게 가져올 수 있다.
ProtocolsPerHandle -
EFI_BOOT_SERVICES.ProtocolsPerHandle()
Summary:
Retrieves the list of protocol interface GUIDs that are installed on a handle in a buffer allocated from pool.
Prototype:
typedef
EFI_STATUS
(EFIAPI *EFI_PROTOCOLS_PER_HANDLE) (
IN EFI_HANDLE Handle,
OUT EFI_GUID ***ProtocolBuffer,
OUT UINTN *ProtocolBufferCount
);
Parameters:
Handle The handle from which to retrieve the list of protocol interface GUIDs.
ProtocolBuffer A pointer to the list of protocol interface GUID pointers that are installed on Handle. This buffer is allocated with a call to the Boot Service EFI_BOOT_SERVICES.AllocatePool(). It is the caller's responsibility to call the Boot Service EFI_BOOT_SERVICES.FreePool() when the caller no longer requires the contents of ProtocolBuffer.
ProtocolBufferCountA pointer to the number of GUID pointers present in ProtocolBuffer.
Description:
The ProtocolsPerHandle() function retrieves the list of protocol interface GUIDs that are installed on Handle. The list is returned in ProtocolBuffer, and the number of GUID pointers in ProtocolBuffer is returned in ProtocolBufferCount.
If Handle is NULL or Handle is NULL, then EFI_INVALID_PARAMETER is returned.
If ProtocolBuffer is NULL, then EFI_INVALID_PAREMETER is returned.
If ProtocolBufferCount is NULL, then EFI_INVALID_PARAMETER is returned.
If there are not enough resources available to allocate ProtocolBuffer, then EFI_OUT_OF_RESOURCES is
returned.
Status Codes Returned:
EFI_SUCCESS The list of protocol interface GUIDs installed on Handle was returned in
ProtocolBuffer. The number of protocol interface GUIDs was
returned in ProtocolBufferCount.
EFI_INVALID_PARAMETER Handle is NULL.
EFI_INVALID_PARAMETER ProtocolBuffer is NULL.
EFI_INVALID_PARAMETER ProtocolBufferCount is NULL.
EFI_OUT_OF_RESOURCES There is not enough pool memory to store the results.
해당 설명을 읽어보면 버퍼의 할당을 AllocatePool()을 통해서 자동적으로 해주며 해당 버퍼에 대한 해제는 FreePool()을 통해서 사용자가 직접 해야한다고 나와있다.
EFI_BOOT_SERVICES.FreePool()
Summary:
Returns pool memory to the system.
Prototype:
typedef
EFI_STATUS
(EFIAPI *EFI_FREE_POOL) (
IN VOID *Buffer
);
Parameters:
Buffer Pointer to the buffer to free.
Description:
The FreePool() function returns the memory specified by Buffer to the system. On return, the
memory’s type is EfiConventionalMemory. The Buffer that is freed must have been allocated by
AllocatePool().
Status Codes Returned:
EFI_SUCCESS The memory was returned to the system.
EFI_INVALID_PARAMETER Buffer was invalid
API의 사용법에 대해서 숙지하고 있으니 ImageHandle 어플리케이션 아랫 부분에 추가를 시켜보겠다.
Print(L"________\n");
EFI_GUID **ProtocolGuidArray;
UINTN ArrayCount;
EFI_STATUS Status = gBS->ProtocolsPerHandle(ImageHandle,
&ProtocolGuidArray,
&ArrayCount);
if (Status == EFI_SUCCESS) {
for (int i=0; i<ArrayCount; i++) {
Print(L"%g\n", ProtocolGuidArray[i]);
}
FreePool(ProtocolGuidArray);
}
/**
Frees a buffer that was previously allocated with one of the pool allocation functions in the
Memory Allocation Library.
Frees the buffer specified by Buffer. Buffer must have been allocated on a previous call to the
pool allocation services of the Memory Allocation Library. If it is not possible to free pool
resources, then this function will perform no actions.
If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,
then ASSERT().
@param Buffer The pointer to the buffer to free.
**/
VOID
EFIAPI
FreePool (
IN VOID *Buffer
)
{
EFI_STATUS Status;
Status = gBS->FreePool (Buffer);
ASSERT_EFI_ERROR (Status);
}
추가로 FreePool에는 다른 라이브러리들의 구현이 필요하기 때문에 .dsc 파일의 [LibraryClasses] 부분에 추가가 필요하다.