ucxutil.cpp File Reference

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

Include dependency graph for ucxutil.cpp:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
_Must_inspect_result_ NTSTATUS NTAPI	UcxCreateObjectWithTwoContexts (_In_ PWDF_OBJECT_ATTRIBUTES Primary, _In_opt_ PWDF_OBJECT_ATTRIBUTES Secondary, _Out_ WDFOBJECT *Object)
ULONG NTAPI	UcxRandom (VOID)
BOOLEAN NTAPI	UcxVerifierWantsFailure (_In_ ULONG Setting)
ULONG NTAPI	UcxRandomInRange (_In_ ULONG Max)
NTSTATUS NTAPI	UcxRandomErrorStatus (VOID)

Variables
UcxDriverState	UcxDriver

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 10 of file ucxutil.cpp.

Function Documentation

UcxCreateObjectWithTwoContexts()

_Must_inspect_result_ NTSTATUS NTAPI UcxCreateObjectWithTwoContexts	(	_In_ PWDF_OBJECT_ATTRIBUTES	Primary,
		_In_opt_ PWDF_OBJECT_ATTRIBUTES	Secondary,
		_Out_ WDFOBJECT *	Object
	)

Creates a WDF object with a primary set of attributes and an optional second context.

Definition at line 19 of file ucxutil.cpp.

{
    WDF_OBJECT_ATTRIBUTES Extra;
    WDFOBJECT Created;
    NTSTATUS Status;
 
    *Object = NULL;
 
    Status = WdfObjectCreate(Primary, &Created);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("Object create failed 0x%lx\n", Status);
        return Status;
    }
 
    if (Secondary != NULL && Secondary->ContextTypeInfo != NULL)
    {
        Extra = *Secondary;
        Extra.ParentObject = NULL;
        Extra.ExecutionLevel = WdfExecutionLevelInheritFromParent;
        Extra.SynchronizationScope = WdfSynchronizationScopeInheritFromParent;
 
        Status = WdfObjectAllocateContext(Created, &Extra, NULL);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("Client context on object %p failed 0x%lx\n", Created, Status);
            WdfObjectDelete(Created);
            return Status;
        }
    }
 
    *Object = Created;
    return STATUS_SUCCESS;
}

Referenced by UcxController::Create(), UcxRootHub::Create(), UcxUsbDevice::Create(), UcxStaticStreams::Create(), and UcxEndpoint::Create().

UcxRandom()

ULONG NTAPI UcxRandom

(

VOID

)

Definition at line 61 of file ucxutil.cpp.

{
    UcxDriver.RandomSeed = UcxDriver.RandomSeed * 1103515245 + 12345;
 
    return (UcxDriver.RandomSeed / 65536) % 32768;
}

Referenced by UcxRandomErrorStatus(), UcxRandomInRange(), and UcxVerifierWantsFailure().

UcxRandomErrorStatus()

NTSTATUS NTAPI UcxRandomErrorStatus

(

VOID

)

Definition at line 93 of file ucxutil.cpp.

{
    return (NTSTATUS)(0xC0000000 | UcxRandom());
}

Referenced by _IRQL_requires_(), UcxEndpoint::OpenStaticStreams(), and UcxQueryUsbCapability().

UcxRandomInRange()

ULONG NTAPI UcxRandomInRange

(

_In_ ULONG

Max

)

Definition at line 85 of file ucxutil.cpp.

{
    return (UcxRandom() % Max) + 1;
}

Referenced by UcxApplyStreamCountOverride().

UcxVerifierWantsFailure()

BOOLEAN NTAPI UcxVerifierWantsFailure

(

_In_ ULONG

Setting

)

0 never fails, 1 always fails, N fails about once in N calls.

Definition at line 71 of file ucxutil.cpp.

{
    if (Setting == 0)
        return FALSE;
 
    if (Setting == 1)
        return TRUE;
 
    return (32768 / Setting) > UcxRandom();
}

Referenced by _IRQL_requires_(), UcxEndpoint::OpenStaticStreams(), and UcxQueryUsbCapability().

Variable Documentation

UcxDriver

UcxDriverState UcxDriver

Definition at line 13 of file ucxutil.cpp.

Referenced by UcxRandom().