misc.c File Reference

#include "precomp.h"
#include <debug.h>

Include dependency graph for misc.c:

Go to the source code of this file.

Macros
#define	NDEBUG
#define	TAG_KS   'ssKK'

Functions
VOID	CompleteRequest (PIRP Irp, CCHAR PriorityBoost)
PVOID	AllocateItem (IN POOL_TYPE PoolType, IN SIZE_T NumberOfBytes)
VOID	FreeItem (IN PVOID Item)
NTSTATUS	KspCopyCreateRequest (IN PIRP Irp, IN LPWSTR ObjectClass, IN OUT PULONG Size, OUT PVOID *Result)
KSDDKAPI PVOID NTAPI	KsGetObjectFromFileObject (IN PFILE_OBJECT FileObject)
KSDDKAPI KSOBJECTTYPE NTAPI	KsGetObjectTypeFromFileObject (IN PFILE_OBJECT FileObject)
KSOBJECTTYPE NTAPI	KsGetObjectTypeFromIrp (IN PIRP Irp)
PUNKNOWN NTAPI	KsGetOuterUnknown (IN PVOID Object)
KSDDKAPI PVOID NTAPI	KsGetParent (IN PVOID Object)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 11 of file misc.c.

TAG_KS

#define TAG_KS   'ssKK'

Definition at line 14 of file misc.c.

Function Documentation

AllocateItem()

PVOID AllocateItem	(	IN POOL_TYPE	PoolType,
		IN SIZE_T	NumberOfBytes
	)

Definition at line 29 of file misc.c.

{
    return ExAllocatePoolZero(PoolType, NumberOfBytes, TAG_KS);
}

Referenced by KspCopyCreateRequest(), USBSTOR_ClassRequest(), and USBSTOR_GetMaxLUN().

CompleteRequest()

VOID CompleteRequest	(	PIRP	Irp,
		CCHAR	PriorityBoost
	)

Definition at line 17 of file misc.c.

{
    DPRINT("Completing IRP %p Status %x\n", Irp, Irp->IoStatus.Status);
 
    ASSERT(Irp->IoStatus.Status != STATUS_PENDING);
 
    IoCompleteRequest(Irp, PriorityBoost);
}

FreeItem()

VOID FreeItem

(

IN PVOID

Item

)

Definition at line 37 of file misc.c.

{
    ExFreePoolWithTag(Item, TAG_KS);
}

Referenced by USBSTOR_ClassRequest(), and USBSTOR_GetMaxLUN().

KsGetObjectFromFileObject()

KSDDKAPI PVOID NTAPI KsGetObjectFromFileObject

(

IN PFILE_OBJECT

FileObject

)

Definition at line 88 of file misc.c.

{
    PKSIOBJECT_HEADER ObjectHeader;
 
    /* get object header */
    ObjectHeader = (PKSIOBJECT_HEADER)FileObject->FsContext2;
 
    /* return associated object */
    return ObjectHeader->ObjectType;
}

KsGetObjectTypeFromFileObject()

KSDDKAPI KSOBJECTTYPE NTAPI KsGetObjectTypeFromFileObject

(

IN PFILE_OBJECT

FileObject

)

Definition at line 106 of file misc.c.

{
    PKSIOBJECT_HEADER ObjectHeader;
 
    /* get object header */
    ObjectHeader = (PKSIOBJECT_HEADER)FileObject->FsContext2;
    /* return type */
    return ObjectHeader->Type;
}

KsGetObjectTypeFromIrp()

KSOBJECTTYPE NTAPI KsGetObjectTypeFromIrp

(

IN PIRP

Irp

)

Definition at line 122 of file misc.c.

{
    PKSIOBJECT_HEADER ObjectHeader;
    PIO_STACK_LOCATION IoStack;
 
    /* get current irp stack */
    IoStack = IoGetCurrentIrpStackLocation(Irp);
    /* get object header */
    ObjectHeader = (PKSIOBJECT_HEADER)IoStack->FileObject->FsContext2;
    /* return type */
    return ObjectHeader->Type;
}

KsGetOuterUnknown()

PUNKNOWN NTAPI KsGetOuterUnknown

(

IN PVOID

Object

)

Definition at line 141 of file misc.c.

{
    PKSBASIC_HEADER BasicHeader = (PKSBASIC_HEADER)((ULONG_PTR)Object - sizeof(KSBASIC_HEADER));
 
    /* sanity check */
    ASSERT(BasicHeader->Type == KsObjectTypeDevice || BasicHeader->Type == KsObjectTypeFilterFactory ||
           BasicHeader->Type == KsObjectTypeFilter || BasicHeader->Type == KsObjectTypePin);
 
    /* return objects outer unknown */
    return BasicHeader->OuterUnknown;
}

KsGetParent()

KSDDKAPI PVOID NTAPI KsGetParent

(

IN PVOID

Object

)

Definition at line 160 of file misc.c.

{
    PKSBASIC_HEADER BasicHeader = (PKSBASIC_HEADER)((ULONG_PTR)Object - sizeof(KSBASIC_HEADER));
    /* sanity check */
    ASSERT(BasicHeader->Parent.KsDevice != NULL);
    /* return object type */
    return (PVOID)BasicHeader->Parent.KsDevice;
}

Referenced by USBAudioFilterCreate().

KspCopyCreateRequest()

NTSTATUS KspCopyCreateRequest	(	IN PIRP	Irp,
		IN LPWSTR	ObjectClass,
		IN OUT PULONG	Size,
		OUT PVOID *	Result
	)

Definition at line 44 of file misc.c.

{
    PIO_STACK_LOCATION IoStack;
    SIZE_T ObjectLength, ParametersLength;
    PVOID Buffer;
 
    /* get current irp stack */
    IoStack = IoGetCurrentIrpStackLocation(Irp);
 
    /* get object class length */
    ObjectLength = (wcslen(ObjectClass) + 1) * sizeof(WCHAR);
 
    /* check for minium length requirement */
    if (ObjectLength  + *Size > IoStack->FileObject->FileName.MaximumLength)
        return STATUS_UNSUCCESSFUL;
 
    /* extract parameters length */
    ParametersLength = IoStack->FileObject->FileName.MaximumLength - ObjectLength;
 
    /* allocate buffer */
    Buffer = AllocateItem(NonPagedPool, ParametersLength);
    if (!Buffer)
        return STATUS_INSUFFICIENT_RESOURCES;
 
    /* copy parameters */
    RtlMoveMemory(Buffer, &IoStack->FileObject->FileName.Buffer[ObjectLength / sizeof(WCHAR)], ParametersLength);
 
    /* store result */
    *Result = Buffer;
    *Size = (ULONG)ParametersLength;
 
    return STATUS_SUCCESS;
}

Referenced by KspValidateConnectRequest(), KsValidateAllocatorCreateRequest(), KsValidateClockCreateRequest(), and KsValidateTopologyNodeCreateRequest().