MdePkg/Library/BaseLib/Ia32/Mwait.c

   1 /** @file
   2   AsmMwait function
   3
   4   Copyright (c) 2006 - 2007, Intel Corporation<BR>
   5   All rights reserved. This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 //
  16 // Include common header file for this module.
  17 //
  18
  19
  20 /**
  21   Executes an MWAIT instruction.
  22
  23   Executes an MWAIT instruction with the register state specified by Eax and
  24   Ecx. Returns Eax. This function is only available on IA-32 and X64.
  25
  26   @param  Eax The value to load into EAX or RAX before executing the MONITOR
  27               instruction.
  28   @param  Ecx The value to load into ECX or RCX before executing the MONITOR
  29               instruction.
  30
  31   @return Eax
  32
  33 **/
  34 UINTN
  35 EFIAPI
  36 AsmMwait (
  37   IN      UINTN                     RegisterEax,
  38   IN      UINTN                     RegisterEcx
  39   )
  40 {
  41   _asm {
  42     mov     eax, RegisterEax
  43     mov     ecx, RegisterEcx
  44     _emit   0x0f              // mwait
  45     _emit   0x01
  46     _emit   0xC9
  47   }
  48 }
  49