DWORD WINAPI RnaOpenMac(HANDLE hConn, HANDLE * lphMAC, LPMAC_OPEN lpmo, DWORD dwSize, HANDLE hEvent)
This function is called by an SMM to request RNA to load the MAC and open the adapter port. The MAC is not activated to any protocol on a successful return. The SMM still needs to activate the MAC and the protocol using a private DeviceIOCTL call.
hConn
The RNA connection handle.
lphMAC
An address to a HANDLE buffer to receive a handle to the loaded MAC. The handle can be used as the device handle for a DeviceIOCTL call in the future.
lpmo
An address to a MAC_OPEN data structure to receive the information of the adapter port on a successful return.
dwSize
The size of the buffer that we get, need to verify that this is large enough to hold the MAC_OPEN data structure.
hEvent
A handle to an event to request for an asynchronous operation. The MAC is required to signal the event if the event is not NULL. If it is NULL, the MAC must perform the operation synchronously.
ERROR_INVALID_HANDLE | The RNA connection handle is invalid. |
ERROR_INVALID_PORT_HANDLE | The RNA connection handle is invalid. |
ERROR_NO_MAC_FOR_PORT | The MAC driver cannot be found or opened. |