wmip.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_WMIP_IRP_CONTEXT
struct	_WMIP_GUID_OBJECT

Macros
#define	GUID_STRING_LENGTH   36

Typedefs
typedef struct _WMIP_IRP_CONTEXT	WMIP_IRP_CONTEXT
typedef struct _WMIP_IRP_CONTEXT *	PWMIP_IRP_CONTEXT
typedef struct _WMIP_GUID_OBJECT	WMIP_GUID_OBJECT
typedef struct _WMIP_GUID_OBJECT *	PWMIP_GUID_OBJECT

Functions
	_Function_class_ (DRIVER_INITIALIZE) _IRQL_requires_same_ NTSTATUS NTAPI WmipDriverEntry(_In_ PDRIVER_OBJECT DriverObject
NTSTATUS NTAPI	WmipInitializeGuidObjectType (VOID)
NTSTATUS NTAPI	WmipOpenGuidObject (_In_ LPCGUID Guid, _In_ ACCESS_MASK DesiredAccess, _In_ KPROCESSOR_MODE AccessMode, _Out_ PHANDLE OutGuidObjectHandle, _Outptr_ PVOID *OutGuidObject)
NTSTATUS NTAPI	WmipOpenGuidObjectByName (_In_ POBJECT_ATTRIBUTES ObjectAttributes, _In_ ACCESS_MASK DesiredAccess, _In_ KPROCESSOR_MODE AccessMode, _Out_ PHANDLE OutGuidObjectHandle, _Outptr_ PVOID *OutGuidObject)
NTSTATUS NTAPI	WmipQueryRawSMBiosTables (_Inout_ ULONG *InOutBufferSize, _Out_opt_ PVOID OutBuffer)

Variables
POBJECT_TYPE	WmipGuidObjectType
_In_ PUNICODE_STRING	RegistryPath

Macro Definition Documentation

GUID_STRING_LENGTH

#define GUID_STRING_LENGTH   36

Definition at line 6 of file wmip.h.

Typedef Documentation

PWMIP_GUID_OBJECT

typedef struct _WMIP_GUID_OBJECT * PWMIP_GUID_OBJECT

PWMIP_IRP_CONTEXT

typedef struct _WMIP_IRP_CONTEXT * PWMIP_IRP_CONTEXT

WMIP_GUID_OBJECT

typedef struct _WMIP_GUID_OBJECT WMIP_GUID_OBJECT

WMIP_IRP_CONTEXT

typedef struct _WMIP_IRP_CONTEXT WMIP_IRP_CONTEXT

Function Documentation

_Function_class_()

_Function_class_

(

DRIVER_INITIALIZE

)

WmipInitializeGuidObjectType()

NTSTATUS NTAPI WmipInitializeGuidObjectType

(

VOID

)

Definition at line 113 of file guidobj.c.

{
    static UNICODE_STRING GuidObjectName = RTL_CONSTANT_STRING(L"WmiGuid");
    OBJECT_TYPE_INITIALIZER ObjectTypeInitializer;
    NTSTATUS Status;

    /* Setup the object type initializer */
    RtlZeroMemory(&ObjectTypeInitializer, sizeof(ObjectTypeInitializer));
    ObjectTypeInitializer.Length = sizeof(ObjectTypeInitializer);
    ObjectTypeInitializer.InvalidAttributes = OBJ_OPENLINK;
    ObjectTypeInitializer.GenericMapping = WmipGenericMapping;
    ObjectTypeInitializer.PoolType = NonPagedPool;
    ObjectTypeInitializer.MaintainHandleCount = FALSE;
    ObjectTypeInitializer.ValidAccessMask = STANDARD_RIGHTS_ALL | 0xFFF;
    ObjectTypeInitializer.SecurityRequired = TRUE;
    ObjectTypeInitializer.DefaultNonPagedPoolCharge = sizeof(WMIP_GUID_OBJECT);
    ObjectTypeInitializer.SecurityProcedure = WmipSecurityMethod;
    ObjectTypeInitializer.DeleteProcedure = WmipDeleteMethod;
    ObjectTypeInitializer.CloseProcedure = WmipCloseMethod;

    /* Create the object type */
    Status = ObCreateObjectType(&GuidObjectName,
                                &ObjectTypeInitializer,
                                0,
                                &WmipGuidObjectType);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("ObCreateObjectType failed: 0x%lx\n", Status);
    }

    return Status;
}

Referenced by WmiInitialize().

WmipOpenGuidObject()

NTSTATUS NTAPI WmipOpenGuidObject	(	_In_ LPCGUID	Guid,
		_In_ ACCESS_MASK	DesiredAccess,
		_In_ KPROCESSOR_MODE	AccessMode,
		_Out_ PHANDLE	OutGuidObjectHandle,
		_Outptr_ PVOID *	OutGuidObject
	)

Definition at line 217 of file guidobj.c.

{
    PWMIP_GUID_OBJECT GuidObject;
    ULONG HandleAttributes;
    NTSTATUS Status;

    /* Create the GUID object */
    Status = WmipCreateGuidObject(Guid, &GuidObject);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("Failed to create GUID object: 0x%lx\n", Status);
        *OutGuidObject = NULL;
        return Status;
    }

    /* Set handle attributes */
    HandleAttributes = (AccessMode == KernelMode) ? OBJ_KERNEL_HANDLE : 0;

    /* Get a handle for the object */
    Status = ObOpenObjectByPointer(GuidObject,
                                   HandleAttributes,
                                   0,
                                   DesiredAccess,
                                   WmipGuidObjectType,
                                   AccessMode,
                                   OutGuidObjectHandle);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("ObOpenObjectByPointer failed: 0x%lx\n", Status);
        ObDereferenceObject(GuidObject);
        GuidObject = NULL;
    }

    *OutGuidObject = GuidObject;

    return Status;
}

Referenced by IoWMIOpenBlock(), and WmipOpenGuidObjectByName().

WmipOpenGuidObjectByName()

NTSTATUS NTAPI WmipOpenGuidObjectByName	(	_In_ POBJECT_ATTRIBUTES	ObjectAttributes,
		_In_ ACCESS_MASK	DesiredAccess,
		_In_ KPROCESSOR_MODE	AccessMode,
		_Out_ PHANDLE	OutGuidObjectHandle,
		_Outptr_ PVOID *	OutGuidObject
	)

Definition at line 262 of file guidobj.c.

{
    static UNICODE_STRING Prefix = RTL_CONSTANT_STRING(L"\\WmiGuid\\");
    UNICODE_STRING GuidString;
    NTSTATUS Status;
    GUID Guid;
    PAGED_CODE();

    /* Check if we have the expected prefix */
    if (!RtlPrefixUnicodeString(&Prefix, ObjectAttributes->ObjectName, FALSE))
    {
        DPRINT1("WMI: Invalid prefix for guid object '%wZ'\n",
                ObjectAttributes->ObjectName);
        return STATUS_INVALID_PARAMETER;
    }

    /* Extract the GUID string */
    GuidString = *ObjectAttributes->ObjectName;
    GuidString.Buffer += Prefix.Length / sizeof(WCHAR);
    GuidString.Length -= Prefix.Length;

    /* Convert the string into a GUID structure */
    Status = WmipGUIDFromString(&GuidString, &Guid);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("WMI: Invalid uuid format for guid '%wZ'\n", &GuidString);
        return Status;
    }

    return WmipOpenGuidObject(&Guid,
                              DesiredAccess,
                              AccessMode,
                              OutGuidObjectHandle,
                              OutGuidObject);
}

Referenced by WmipOpenGuidForEvents(), and WmipRegisterGuids().

WmipQueryRawSMBiosTables()

NTSTATUS NTAPI WmipQueryRawSMBiosTables	(	_Inout_ ULONG *	InOutBufferSize,
		_Out_opt_ PVOID	OutBuffer
	)

FIXME: most of this is fubar

Definition at line 219 of file smbios.c.

{
    NTSTATUS Status;
    PVOID TableData = NULL;
    ULONG TableSize, ResultSize;
    PWNODE_ALL_DATA AllData;

    /* Get the table data */
    Status = WmipGetRawSMBiosTableData(OutBuffer ? &TableData : NULL, &TableSize);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("WmipGetRawSMBiosTableData failed: 0x%08lx\n", Status);
        return Status;
    }

    ResultSize = sizeof(WNODE_ALL_DATA) + TableSize;

    /* Check if the caller provided a buffer */
    if ((OutBuffer != NULL) && (*InOutBufferSize != 0))
    {
        /* Check if the buffer is large enough */
        if (*InOutBufferSize < ResultSize)
        {
            DPRINT1("Buffer too small. Got %lu, need %lu\n",
                    *InOutBufferSize, ResultSize);
            return STATUS_BUFFER_TOO_SMALL;
        }

        AllData = OutBuffer;
        AllData->WnodeHeader.BufferSize = ResultSize;
        AllData->WnodeHeader.ProviderId = 0;
        AllData->WnodeHeader.Version = 0;
        AllData->WnodeHeader.Linkage = 0; // last entry
        //AllData->WnodeHeader.CountLost;
        AllData->WnodeHeader.KernelHandle = NULL;
        //AllData->WnodeHeader.TimeStamp;
        AllData->WnodeHeader.Guid = MSSmBios_RawSMBiosTables_GUID;
        //AllData->WnodeHeader.ClientContext;
        AllData->WnodeHeader.Flags = WNODE_FLAG_FIXED_INSTANCE_SIZE;
        AllData->DataBlockOffset = sizeof(WNODE_ALL_DATA);
        AllData->InstanceCount = 1;
        //AllData->OffsetInstanceNameOffsets;
        AllData->FixedInstanceSize = TableSize;

        RtlCopyMemory(AllData + 1, TableData, TableSize);
    }

    /* Set the size */
    *InOutBufferSize = ResultSize;

    /* Free the table buffer */
    if (TableData != NULL)
    {
        ExFreePoolWithTag(TableData, 'BTMS');
    }

    return STATUS_SUCCESS;
}

Referenced by IoWMIQueryAllData().

Variable Documentation

RegistryPath

_In_ PUNICODE_STRING RegistryPath

Definition at line 28 of file wmip.h.

WmipGuidObjectType

POBJECT_TYPE WmipGuidObjectType

Definition at line 21 of file guidobj.c.

Referenced by WmipCreateGuidObject(), WmipInitializeGuidObjectType(), and WmipOpenGuidObject().