OEMSendIPI (Compact 2013)

3/28/2014

This function sends an interprocessor interrupt (IPI).

Syntax

BOOL OEMSendIPI(
    DWORD dwType,
   DWORD dwTarget
);

Parameters

  • dwType
    Specifies the type of IPI that you want to send.

    The following table shows the possible values.

    Value

    Description

    IPI_TYPE_ALL_BUT_SELF

    Send to all processors except the current processor. The dwTarget parameter is ignored.

    IPI_TYPE_ALL_INCLUDE_SELF

    Send to all processors, including the current processor. The dwTarget parameter is ignored.

    IPI_TYPE_SPECIFIC_CPU

    Send the IPI to the processor that is specified by dwTarget.

  • dwTarget
    If the dwType value is IPI_TYPE_SPECIFIC_CPU, specifies the CPU to which OEMSendIpi sends the IPI, using the hardware processor number (CPU ID) returned by the OEMMpPerCPUInit function. If the dwType value is not IPI_TYPE_SPECIFIC_CPU, the dwTarget parameter is ignored.

    Note

    The hardware processor ID of the main processor is hard-coded to 0 (zero). The secondary processor number is a 1-based index.

Return Value

Returns true if successful; otherwise, returns false.

Remarks

To support multiple processors, you must implement this function. If you implement OEMSendIPI, set the pfnSendIpi member of OEMGLOBAL to point to this function.

Requirements

Header

oemglobal.h

Library

OEMMain.lib or OEMMain_StaticKITL.lib

See Also

Reference

SMP Functions
OEMIpiHandler