Handle.h

Go to the documentation of this file.

 
#ifndef  _HAND_H_
#define  _HAND_H_
 
#define EFI_HANDLE_SIGNATURE  SIGNATURE_32('h','n','d','l')
 
typedef struct {
  UINTN         Signature;
  LIST_ENTRY    AllHandles;
  LIST_ENTRY    Protocols;
  UINTN         LocateRequest;
  UINT64        Key;
} IHANDLE;
 
#define ASSERT_IS_HANDLE(a)  ASSERT((a)->Signature == EFI_HANDLE_SIGNATURE)
 
#define PROTOCOL_ENTRY_SIGNATURE  SIGNATURE_32('p','r','t','e')
 
typedef struct {
  UINTN         Signature;
  LIST_ENTRY    AllEntries;
  EFI_GUID      ProtocolID;
  LIST_ENTRY    Protocols;
  LIST_ENTRY    Notify;
} PROTOCOL_ENTRY;
 
#define PROTOCOL_INTERFACE_SIGNATURE  SIGNATURE_32('p','i','f','c')
 
typedef struct {
  UINTN             Signature;
  LIST_ENTRY        Link;
  IHANDLE           *Handle;
  LIST_ENTRY        ByProtocol;
  PROTOCOL_ENTRY    *Protocol;
  VOID              *Interface;
  LIST_ENTRY        OpenList;
  UINTN             OpenListCount;
} PROTOCOL_INTERFACE;
 
#define OPEN_PROTOCOL_DATA_SIGNATURE  SIGNATURE_32('p','o','d','l')
 
typedef struct {
  UINTN         Signature;
  LIST_ENTRY    Link;
 
  EFI_HANDLE    AgentHandle;
  EFI_HANDLE    ControllerHandle;
  UINT32        Attributes;
  UINT32        OpenCount;
} OPEN_PROTOCOL_DATA;
 
#define PROTOCOL_NOTIFY_SIGNATURE  SIGNATURE_32('p','r','t','n')
 
typedef struct {
  UINTN             Signature;
  PROTOCOL_ENTRY    *Protocol;
  LIST_ENTRY        Link;
  EFI_EVENT         Event;
  LIST_ENTRY        *Position;
} PROTOCOL_NOTIFY;
 
PROTOCOL_ENTRY  *
CoreFindProtocolEntry (
  IN EFI_GUID  *Protocol,
  IN BOOLEAN   Create
  );
 
VOID
CoreNotifyProtocolEntry (
  IN PROTOCOL_ENTRY  *ProtEntry
  );
 
PROTOCOL_INTERFACE *
CoreFindProtocolInterface (
  IN IHANDLE   *Handle,
  IN EFI_GUID  *Protocol,
  IN VOID      *Interface
  );
 
PROTOCOL_INTERFACE *
CoreRemoveInterfaceFromProtocol (
  IN IHANDLE   *Handle,
  IN EFI_GUID  *Protocol,
  IN VOID      *Interface
  );
 
EFI_STATUS
CoreConnectSingleController (
  IN  EFI_HANDLE                ControllerHandle,
  IN  EFI_HANDLE                *ContextDriverImageHandles OPTIONAL,
  IN  EFI_DEVICE_PATH_PROTOCOL  *RemainingDevicePath       OPTIONAL
  );
 
EFI_STATUS
CoreDisconnectControllersUsingProtocolInterface (
  IN EFI_HANDLE          UserHandle,
  IN PROTOCOL_INTERFACE  *Prot
  );
 
VOID
CoreAcquireProtocolLock (
  VOID
  );
 
VOID
CoreReleaseProtocolLock (
  VOID
  );
 
EFI_STATUS
CoreValidateHandle (
  IN  EFI_HANDLE  UserHandle
  );
 
//
// Externs
//
extern EFI_LOCK    gProtocolDatabaseLock;
extern LIST_ENTRY  gHandleList;
extern UINT64      gHandleDatabaseKey;
 
#endif