MdePkg/Library/BaseLib/DivU64x32.c

   1 /** @file
   2   Math worker functions.
   3
   4   Copyright (c) 2006, 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 #include "CommonHeader.h"
  19
  20 #include "BaseLibInternals.h"
  21
  22 /**
  23   Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates
  24   a 64-bit unsigned result.
  25
  26   This function divides the 64-bit unsigned value Dividend by the 32-bit
  27   unsigned value Divisor and generates a 64-bit unsigned quotient. This
  28   function returns the 64-bit unsigned quotient.
  29
  30   If Divisor is 0, then ASSERT().
  31
  32   @param  Dividend  A 64-bit unsigned value.
  33   @param  Divisor   A 32-bit unsigned value.
  34
  35   @return Dividend / Divisor
  36
  37 **/
  38 UINT64
  39 EFIAPI
  40 DivU64x32 (
  41   IN      UINT64                    Dividend,
  42   IN      UINT32                    Divisor
  43   )
  44 {
  45   ASSERT (Divisor != 0);
  46   return InternalMathDivU64x32 (Dividend, Divisor);
  47 }