windows-nt-4.0/private/ntos/lpc/lpcp.h

/*++

Copyright (c) 1989  Microsoft Corporation

Module Name:

    lpcp.h

Abstract:

    Private include file for the LPC subcomponent of the NTOS project

Author:

    Steve Wood (stevewo) 15-May-1989

Revision History:

--*/

#include "ntos.h"
#include <zwapi.h>

//
// Global Mutex to guard the following fields:
//
//  ETHREAD.LpcReplyMsg
//  LPCP_PORT_QUEUE.ReceiveHead
//
// Mutex is never held longer than is necessary to modify or read the field.
//

extern FAST_MUTEX LpcpLock;
LPCP_PORT_ZONE LpcpZone;
BOOLEAN LpcpRequestMsgType[];
ULONG LpcpNextMessageId;
ULONG LpcpNextCallbackId;

#define LpcpGenerateMessageId() \
    LpcpNextMessageId++;    if (LpcpNextMessageId == 0) LpcpNextMessageId = 1;

#define LpcpGenerateCallbackId() \
    LpcpNextCallbackId++;    if (LpcpNextCallbackId == 0) LpcpNextCallbackId = 1;


#if DEVL
ULONG LpcpTotalNumberOfMessages;
#endif

//
// Internal Entry Points defined in lpcclose.c
//

VOID
LpcpClosePort(
    IN PEPROCESS Process OPTIONAL,
    IN PVOID Object,
    IN ACCESS_MASK GrantedAccess,
    IN ULONG ProcessHandleCount,
    IN ULONG SystemHandleCount
    );


VOID
LpcpDeletePort(
    IN PVOID Object
    );


//
// Entry points defined in lpcqueue.c
//

NTSTATUS
LpcpInitializePortQueue(
    IN PLPCP_PORT_OBJECT Port
    );

VOID
LpcpDestroyPortQueue(
    IN PLPCP_PORT_OBJECT Port,
    IN BOOLEAN CleanupAndDestroy
    );

NTSTATUS
LpcpInitializePortZone(
    IN ULONG MaxEntrySize,
    IN ULONG SegmentSize,
    IN ULONG MaxPoolUsage
    );

NTSTATUS
LpcpExtendPortZone(
    VOID
    );

//
// Entry points defined in lpcquery.c
//


//
// Entry points defined in lpcmove.s
//

VOID
LpcpMoveMessage(
    OUT PPORT_MESSAGE DstMsg,
    IN PPORT_MESSAGE SrcMsg,
    IN PVOID SrcMsgData,
    IN ULONG MsgType OPTIONAL,
    IN PCLIENT_ID ClientId OPTIONAL
    );

//
// Internal Entry Points defined in lpcpriv.c
//

VOID
LpcpFreePortClientSecurity(
    IN PLPCP_PORT_OBJECT Port
    );

//
// Macro Procedures used by RequestWaitReply, Reply, ReplyWaitReceive,
// and ReplyWaitReply services
//

#define                                                             \
LpcpGetDynamicClientSecurity(                                       \
    Thread,                                                         \
    Port,                                                           \
    DynamicSecurity                                                 \
    )                                                               \
SeCreateClientSecurity(                                             \
    (Thread),                                                       \
    &(Port)->SecurityQos,                                           \
    FALSE,                                                          \
    (DynamicSecurity)                                               \
    )

#define                                                             \
LpcpFreeDynamicClientSecurity(                                      \
    DynamicSecurity                                                 \
    )                                                               \
SeDeleteClientSecurity( DynamicSecurity )



#define                                                             \
LpcpReferencePortObject(                                            \
    PortHandle,                                                     \
    PortAccess,                                                     \
    PreviousMode,                                                   \
    PortObject                                                      \
    )                                                               \
ObReferenceObjectByHandle( (PortHandle),                            \
                           (PortAccess),                            \
                           LpcPortObjectType,                       \
                           (PreviousMode),                          \
                           (PVOID *)(PortObject),                   \
                           NULL                                     \
                         )


PLPCP_MESSAGE
FASTCALL
LpcpAllocateFromPortZone(
    ULONG Size
    );

VOID
FASTCALL
LpcpFreeToPortZone(
    IN PLPCP_MESSAGE Msg,
    IN BOOLEAN MutexOwned
    );

VOID
LpcpSaveDataInfoMessage(
    IN PLPCP_PORT_OBJECT Port,
    PLPCP_MESSAGE Msg
    );

VOID
LpcpFreeDataInfoMessage(
    IN PLPCP_PORT_OBJECT Port,
    IN ULONG MessageId,
    IN ULONG CallbackId
    );

PLPCP_MESSAGE
LpcpFindDataInfoMessage(
    IN PLPCP_PORT_OBJECT Port,
    IN ULONG MessageId,
    IN ULONG CallbackId
    );


#if DBG
#define ENABLE_LPC_TRACING 1
#else
#define ENABLE_LPC_TRACING 0
#endif

#if ENABLE_LPC_TRACING
BOOLEAN LpcpStopOnReplyMismatch;
BOOLEAN LpcpTraceMessages;

char *LpcpMessageTypeName[];

char *
LpcpGetCreatorName(
    PLPCP_PORT_OBJECT PortObject
    );

#define LpcpPrint( _x_ ) DbgPrint( "LPC[ %02x.%02x ]: ",                    \
                                   PsGetCurrentThread()->Cid.UniqueProcess, \
                                   PsGetCurrentThread()->Cid.UniqueThread   \
                                 );                                         \
                         DbgPrint _x_

#define LpcpTrace( _x_ ) if (LpcpTraceMessages) { LpcpPrint( _x_ ); }

#else

#define LpcpPrint( _x_ )
#define LpcpTrace( _x_ )

#endif // ENABLE_LPC_TRACING