win32k.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for win32k.c:

Go to the source code of this file.

Classes
struct	_WIN32_KERNEL_OBJECT_HEADER

Macros
#define	NDEBUG

Typedefs
typedef struct _WIN32_KERNEL_OBJECT_HEADER	WIN32_KERNEL_OBJECT_HEADER
typedef struct _WIN32_KERNEL_OBJECT_HEADER *	PWIN32_KERNEL_OBJECT_HEADER

Functions
NTSTATUS NTAPI	ExpWin32SessionCallout (_In_ PVOID Object, _In_ PKWIN32_SESSION_CALLOUT CalloutProcedure, _Inout_opt_ PVOID Parameter)
BOOLEAN NTAPI	ExpDesktopOkToClose (IN PEPROCESS Process OPTIONAL, IN PVOID Object, IN HANDLE Handle, IN KPROCESSOR_MODE AccessMode)
BOOLEAN NTAPI	ExpWindowStationOkToClose (IN PEPROCESS Process OPTIONAL, IN PVOID Object, IN HANDLE Handle, IN KPROCESSOR_MODE AccessMode)
VOID NTAPI	ExpWinStaObjectDelete (PVOID DeletedObject)
NTSTATUS NTAPI	ExpWinStaObjectParse (IN PVOID ParseObject, IN PVOID ObjectType, IN OUT PACCESS_STATE AccessState, IN KPROCESSOR_MODE AccessMode, IN ULONG Attributes, IN OUT PUNICODE_STRING CompleteName, IN OUT PUNICODE_STRING RemainingName, IN OUT PVOID Context OPTIONAL, IN PSECURITY_QUALITY_OF_SERVICE SecurityQos OPTIONAL, OUT PVOID *Object)
VOID NTAPI	ExpDesktopDelete (PVOID DeletedObject)
NTSTATUS NTAPI	ExpDesktopOpen (IN OB_OPEN_REASON Reason, IN PEPROCESS Process OPTIONAL, IN PVOID ObjectBody, IN ACCESS_MASK GrantedAccess, IN ULONG HandleCount)
VOID NTAPI	ExpDesktopClose (IN PEPROCESS Process OPTIONAL, IN PVOID Object, IN ACCESS_MASK GrantedAccess, IN ULONG ProcessHandleCount, IN ULONG SystemHandleCount)
BOOLEAN NTAPI	ExpWin32kInit (VOID)

Variables
POBJECT_TYPE	ExWindowStationObjectType = NULL
POBJECT_TYPE	ExDesktopObjectType = NULL
GENERIC_MAPPING	ExpWindowStationMapping
GENERIC_MAPPING	ExpDesktopMapping
PKWIN32_SESSION_CALLOUT	ExpWindowStationObjectParse = NULL
PKWIN32_SESSION_CALLOUT	ExpWindowStationObjectDelete = NULL
PKWIN32_SESSION_CALLOUT	ExpWindowStationObjectOkToClose = NULL
PKWIN32_SESSION_CALLOUT	ExpDesktopObjectOkToClose = NULL
PKWIN32_SESSION_CALLOUT	ExpDesktopObjectDelete = NULL
PKWIN32_SESSION_CALLOUT	ExpDesktopObjectOpen = NULL
PKWIN32_SESSION_CALLOUT	ExpDesktopObjectClose = NULL

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 10 of file win32k.c.

Typedef Documentation

PWIN32_KERNEL_OBJECT_HEADER

typedef struct _WIN32_KERNEL_OBJECT_HEADER * PWIN32_KERNEL_OBJECT_HEADER

WIN32_KERNEL_OBJECT_HEADER

typedef struct _WIN32_KERNEL_OBJECT_HEADER WIN32_KERNEL_OBJECT_HEADER

Function Documentation

ExpDesktopClose()

VOID NTAPI ExpDesktopClose	(	IN PEPROCESS Process	OPTIONAL,
		IN PVOID	Object,
		IN ACCESS_MASK	GrantedAccess,
		IN ULONG	ProcessHandleCount,
		IN ULONG	SystemHandleCount
	)

Definition at line 237 of file win32k.c.

{
    WIN32_CLOSEMETHOD_PARAMETERS Parameters;
 
    Parameters.Process = Process;
    Parameters.Object = Object;
    Parameters.AccessMask = GrantedAccess;
    Parameters.ProcessHandleCount = ProcessHandleCount;
    Parameters.SystemHandleCount = SystemHandleCount;
 
    ExpWin32SessionCallout(Object,
                           ExpDesktopObjectClose,
                           &Parameters);
}

Referenced by ExpWin32kInit().

ExpDesktopDelete()

VOID NTAPI ExpDesktopDelete

(

PVOID

DeletedObject

)

Definition at line 202 of file win32k.c.

{
    WIN32_DELETEMETHOD_PARAMETERS Parameters;
 
    /* Fill out the callback structure */
    Parameters.Object = DeletedObject;
 
    ExpWin32SessionCallout(DeletedObject,
                           ExpDesktopObjectDelete,
                           &Parameters);
}

Referenced by ExpWin32kInit().

ExpDesktopOkToClose()

BOOLEAN NTAPI ExpDesktopOkToClose	(	IN PEPROCESS Process	OPTIONAL,
		IN PVOID	Object,
		IN HANDLE	Handle,
		IN KPROCESSOR_MODE	AccessMode
	)

Definition at line 113 of file win32k.c.

{
    WIN32_OKAYTOCLOSEMETHOD_PARAMETERS Parameters;
    NTSTATUS Status;
 
    Parameters.Process = Process;
    Parameters.Object = Object;
    Parameters.Handle = Handle;
    Parameters.PreviousMode = AccessMode;
 
    Status = ExpWin32SessionCallout(Object,
                                    ExpDesktopObjectOkToClose,
                                    &Parameters);
 
    return NT_SUCCESS(Status);
}

Referenced by ExpWin32kInit().

ExpDesktopOpen()

NTSTATUS NTAPI ExpDesktopOpen	(	IN OB_OPEN_REASON	Reason,
		IN PEPROCESS Process	OPTIONAL,
		IN PVOID	ObjectBody,
		IN ACCESS_MASK	GrantedAccess,
		IN ULONG	HandleCount
	)

Definition at line 216 of file win32k.c.

{
    WIN32_OPENMETHOD_PARAMETERS Parameters;
 
    Parameters.OpenReason = Reason;
    Parameters.Process = Process;
    Parameters.Object = ObjectBody;
    Parameters.GrantedAccess = GrantedAccess;
    Parameters.HandleCount = HandleCount;
 
    return ExpWin32SessionCallout(ObjectBody,
                                  ExpDesktopObjectOpen,
                                  &Parameters);
}

Referenced by ExpWin32kInit().

ExpWin32kInit()

BOOLEAN NTAPI ExpWin32kInit

(

VOID

)

Definition at line 259 of file win32k.c.

{
    OBJECT_TYPE_INITIALIZER ObjectTypeInitializer;
    UNICODE_STRING Name;
    NTSTATUS Status;
    DPRINT("Creating Win32 Object Types\n");
 
    /* Create the window station Object Type */
    RtlZeroMemory(&ObjectTypeInitializer, sizeof(ObjectTypeInitializer));
    RtlInitUnicodeString(&Name, L"WindowStation");
    ObjectTypeInitializer.Length = sizeof(ObjectTypeInitializer);
    ObjectTypeInitializer.GenericMapping = ExpWindowStationMapping;
    ObjectTypeInitializer.PoolType = NonPagedPool;
    ObjectTypeInitializer.DeleteProcedure = ExpWinStaObjectDelete;
    ObjectTypeInitializer.ParseProcedure = ExpWinStaObjectParse;
    ObjectTypeInitializer.OkayToCloseProcedure = ExpWindowStationOkToClose;
    ObjectTypeInitializer.SecurityRequired = TRUE;
    ObjectTypeInitializer.InvalidAttributes = OBJ_OPENLINK |
                                              OBJ_PERMANENT |
                                              OBJ_EXCLUSIVE;
    ObjectTypeInitializer.ValidAccessMask = STANDARD_RIGHTS_REQUIRED;
    Status = ObCreateObjectType(&Name,
                                &ObjectTypeInitializer,
                                NULL,
                                &ExWindowStationObjectType);
    if (!NT_SUCCESS(Status)) return FALSE;
 
    /* Create desktop object type */
    RtlInitUnicodeString(&Name, L"Desktop");
    ObjectTypeInitializer.GenericMapping = ExpDesktopMapping;
    ObjectTypeInitializer.DeleteProcedure = ExpDesktopDelete;
    ObjectTypeInitializer.ParseProcedure = NULL;
    ObjectTypeInitializer.OkayToCloseProcedure = ExpDesktopOkToClose;
    ObjectTypeInitializer.OpenProcedure = ExpDesktopOpen;
    ObjectTypeInitializer.CloseProcedure = ExpDesktopClose;
    Status = ObCreateObjectType(&Name,
                                &ObjectTypeInitializer,
                                NULL,
                                &ExDesktopObjectType);
    if (!NT_SUCCESS(Status)) return FALSE;
 
    return TRUE;
}

Referenced by ExpInitSystemPhase1().

ExpWin32SessionCallout()

NTSTATUS NTAPI ExpWin32SessionCallout	(	_In_ PVOID	Object,
		_In_ PKWIN32_SESSION_CALLOUT	CalloutProcedure,
		_Inout_opt_ PVOID	Parameter
	)

Definition at line 52 of file win32k.c.

{
    PWIN32_KERNEL_OBJECT_HEADER Win32ObjectHeader;
    PVOID SessionEntry = NULL;
    KAPC_STATE ApcState;
    NTSTATUS Status;
 
    /* The objects have a common header. And the kernel accesses it!
       Thanks MS for this kind of retarded "design"! */
    Win32ObjectHeader = Object;
 
    /* Check if we are not already in the correct session */
    if (!PsGetCurrentProcess()->ProcessInSession ||
        (PsGetCurrentProcessSessionId() != Win32ObjectHeader->SessionId))
    {
        /* Get the session from the objects session Id */
        DPRINT("SessionId == %d\n", Win32ObjectHeader->SessionId);
        SessionEntry = MmGetSessionById(Win32ObjectHeader->SessionId);
        if (SessionEntry == NULL)
        {
            /* The requested session does not even exist! */
            ASSERT(FALSE);
            return STATUS_NOT_FOUND;
        }
 
        /* Attach to the session */
        Status = MmAttachSession(SessionEntry, &ApcState);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("Could not attach to 0x%p, object %p, callout 0x%p\n",
                    SessionEntry,
                    Win32ObjectHeader,
                    CalloutProcedure);
 
            /* Cleanup and return */
            MmQuitNextSession(SessionEntry);
            ASSERT(FALSE);
            return Status;
        }
    }
 
    /* Call the callout routine */
    Status = CalloutProcedure(Parameter);
 
    /* Check if we have a session */
    if (SessionEntry != NULL)
    {
        /* Detach from the session and quit using it */
        MmDetachSession(SessionEntry, &ApcState);
        MmQuitNextSession(SessionEntry);
    }
 
    /* Return the callback status */
    return Status;
}

Referenced by ExpDesktopClose(), ExpDesktopDelete(), ExpDesktopOkToClose(), ExpDesktopOpen(), ExpWindowStationOkToClose(), ExpWinStaObjectDelete(), and ExpWinStaObjectParse().

ExpWindowStationOkToClose()

BOOLEAN NTAPI ExpWindowStationOkToClose	(	IN PEPROCESS Process	OPTIONAL,
		IN PVOID	Object,
		IN HANDLE	Handle,
		IN KPROCESSOR_MODE	AccessMode
	)

Definition at line 135 of file win32k.c.

{
    WIN32_OKAYTOCLOSEMETHOD_PARAMETERS Parameters;
    NTSTATUS Status;
 
    Parameters.Process = Process;
    Parameters.Object = Object;
    Parameters.Handle = Handle;
    Parameters.PreviousMode = AccessMode;
 
    Status = ExpWin32SessionCallout(Object,
                                    ExpWindowStationObjectOkToClose,
                                    &Parameters);
 
    return NT_SUCCESS(Status);
}

Referenced by ExpWin32kInit().

ExpWinStaObjectDelete()

VOID NTAPI ExpWinStaObjectDelete

(

PVOID

DeletedObject

)

Definition at line 157 of file win32k.c.

{
    WIN32_DELETEMETHOD_PARAMETERS Parameters;
 
    /* Fill out the callback structure */
    Parameters.Object = DeletedObject;
 
    ExpWin32SessionCallout(DeletedObject,
                           ExpWindowStationObjectDelete,
                           &Parameters);
}

Referenced by ExpWin32kInit().

ExpWinStaObjectParse()

NTSTATUS NTAPI ExpWinStaObjectParse	(	IN PVOID	ParseObject,
		IN PVOID	ObjectType,
		IN OUT PACCESS_STATE	AccessState,
		IN KPROCESSOR_MODE	AccessMode,
		IN ULONG	Attributes,
		IN OUT PUNICODE_STRING	CompleteName,
		IN OUT PUNICODE_STRING	RemainingName,
		IN OUT PVOID Context	OPTIONAL,
		IN PSECURITY_QUALITY_OF_SERVICE SecurityQos	OPTIONAL,
		OUT PVOID *	Object
	)

Definition at line 171 of file win32k.c.

{
    WIN32_PARSEMETHOD_PARAMETERS Parameters;
 
    /* Fill out the callback structure */
    Parameters.ParseObject = ParseObject;
    Parameters.ObjectType = ObjectType;
    Parameters.AccessState = AccessState;
    Parameters.AccessMode = AccessMode;
    Parameters.Attributes = Attributes;
    Parameters.CompleteName = CompleteName;
    Parameters.RemainingName = RemainingName;
    Parameters.Context = Context;
    Parameters.SecurityQos = SecurityQos;
    Parameters.Object = Object;
 
    return ExpWin32SessionCallout(ParseObject,
                                  ExpWindowStationObjectParse,
                                  &Parameters);
}

Referenced by ExpWin32kInit().

Variable Documentation

ExDesktopObjectType

POBJECT_TYPE ExDesktopObjectType = NULL

Definition at line 22 of file win32k.c.

Referenced by ExpWin32kInit(), InitDesktopImpl(), IntAssignDesktopSecurityOnParse(), IntCreateDesktop(), IntDesktopObjectParse(), IntGetDesktopObjectHandle(), IntResolveDesktop(), IntValidateDesktopHandle(), IntWinStaObjectParse(), NtUserConsoleControl(), NtUserGetThreadDesktop(), NtUserOpenDesktop(), TestWin2003ObjectTypes(), and UserOpenInputDesktop().

ExpDesktopMapping

GENERIC_MAPPING ExpDesktopMapping

Initial value:

=
{
    STANDARD_RIGHTS_READ,
    STANDARD_RIGHTS_WRITE,
    STANDARD_RIGHTS_EXECUTE,
    STANDARD_RIGHTS_REQUIRED
}

Definition at line 32 of file win32k.c.

Referenced by ExpWin32kInit().

ExpDesktopObjectClose

PKWIN32_SESSION_CALLOUT ExpDesktopObjectClose = NULL

Definition at line 46 of file win32k.c.

Referenced by ExpDesktopClose(), and PsEstablishWin32Callouts().

ExpDesktopObjectDelete

PKWIN32_SESSION_CALLOUT ExpDesktopObjectDelete = NULL

Definition at line 44 of file win32k.c.

Referenced by ExpDesktopDelete(), and PsEstablishWin32Callouts().

ExpDesktopObjectOkToClose

PKWIN32_SESSION_CALLOUT ExpDesktopObjectOkToClose = NULL

Definition at line 43 of file win32k.c.

Referenced by ExpDesktopOkToClose(), and PsEstablishWin32Callouts().

ExpDesktopObjectOpen

PKWIN32_SESSION_CALLOUT ExpDesktopObjectOpen = NULL

Definition at line 45 of file win32k.c.

Referenced by ExpDesktopOpen(), and PsEstablishWin32Callouts().

ExpWindowStationMapping

GENERIC_MAPPING ExpWindowStationMapping

Initial value:

=
{
    STANDARD_RIGHTS_READ,
    STANDARD_RIGHTS_WRITE,
    STANDARD_RIGHTS_EXECUTE,
    STANDARD_RIGHTS_REQUIRED
}

Definition at line 24 of file win32k.c.

Referenced by ExpWin32kInit().

ExpWindowStationObjectDelete

PKWIN32_SESSION_CALLOUT ExpWindowStationObjectDelete = NULL

Definition at line 41 of file win32k.c.

Referenced by ExpWinStaObjectDelete(), and PsEstablishWin32Callouts().

ExpWindowStationObjectOkToClose

PKWIN32_SESSION_CALLOUT ExpWindowStationObjectOkToClose = NULL

Definition at line 42 of file win32k.c.

Referenced by ExpWindowStationOkToClose(), and PsEstablishWin32Callouts().

ExpWindowStationObjectParse

PKWIN32_SESSION_CALLOUT ExpWindowStationObjectParse = NULL

Definition at line 40 of file win32k.c.

Referenced by ExpWinStaObjectParse(), and PsEstablishWin32Callouts().

ExWindowStationObjectType

POBJECT_TYPE ExWindowStationObjectType = NULL

Definition at line 21 of file win32k.c.

Referenced by co_UserCreateWindowEx(), ExpWin32kInit(), InitWindowStationImpl(), IntCreateWindowStation(), IntResolveDesktop(), IntValidateWindowStationHandle(), IntWinStaObjectParse(), NtUserGetObjectInformation(), NtUserOpenWindowStation(), RawInputThreadMain(), TestWin2003ObjectTypes(), and UserSetProcessWindowStation().