TianoCore EDK2 master
Loading...
Searching...
No Matches
Enumeration APIs

Typedefs

typedef BOOLEAN(EFIAPI * EDKII_AML_TREE_ENUM_CALLBACK) (IN AML_NODE_HANDLE Node, IN OUT VOID *Context OPTIONAL, IN OUT EFI_STATUS *Status OPTIONAL)
 

Functions

BOOLEAN EFIAPI AmlEnumTree (IN AML_NODE_HANDLE Node, IN EDKII_AML_TREE_ENUM_CALLBACK CallBack, IN OUT VOID *Context OPTIONAL, OUT EFI_STATUS *Status OPTIONAL)
 

Detailed Description

Enumeration APIs are navigation APIs, allowing to call a callback function on each node enumerated. Nodes are enumerated in the AML bytestream order, i.e. in a depth first order.

Typedef Documentation

◆ EDKII_AML_TREE_ENUM_CALLBACK

typedef BOOLEAN(EFIAPI * EDKII_AML_TREE_ENUM_CALLBACK) (IN AML_NODE_HANDLE Node, IN OUT VOID *Context OPTIONAL, IN OUT EFI_STATUS *Status OPTIONAL)

Callback function prototype used when iterating through the tree.

Parameters
[in]NodeThe Node currently being processed.
[in,out]ContextA context for the callback function. Can be optional.
[in,out]StatusEnd the enumeration if pointing to a value evaluated to TRUE. Can be optional.
Return values
TRUEif the enumeration can continue or has finished without interruption.
FALSEif the enumeration needs to stopped or has stopped.

Definition at line 684 of file AmlCoreInterface.h.

Function Documentation

◆ AmlEnumTree()

BOOLEAN EFIAPI AmlEnumTree ( IN AML_NODE_HANDLE  Node,
IN EDKII_AML_TREE_ENUM_CALLBACK  CallBack,
IN OUT VOID *Context  OPTIONAL,
OUT EFI_STATUS *Status  OPTIONAL 
)

Enumerate all nodes of the subtree under the input Node in the AML bytestream order (i.e. in a depth first order), and call the CallBack function with the input Context. The prototype of the Callback function is EDKII_AML_TREE_ENUM_CALLBACK.

Parameters
[in]NodeEnumerate nodes of the subtree under this Node. Must be a valid node.
[in]CallBackCallback function to call on each node.
[in,out]ContextVoid pointer used to pass some information to the Callback function. Optional, can be NULL.
[out]StatusOptional parameter that can be used to get the status of the Callback function. If used, need to be init to EFI_SUCCESS.
Return values
TRUEif the enumeration can continue or has finished without interruption.
FALSEif the enumeration needs to stopped or has stopped.