mirror of
https://github.com/ApfelTeeSaft/reactos.git
synced 2026-08-27 11:53:32 +00:00
3fe5b8b0bb
[SDK][WDFLDR] Add kmdf loader driver [SDK][WDF] Add kmdf drver init static library [SDK][WDF] Modify kmdf driver for working with wdfldr driver [SDK][CDROM] Cdrom driver dynamically linking with kmdf [SDK][WDF] Add kmdfdriver module type [SDK][WDF][USBDEX][NTOSKRNL_VISTA] Fully enable KMDF [KMDF][WDFLDR][WDF01000] Fix Windows 10 Compatibility WDFLDR and WDF01000 [WDF01000] NO_KERNEL_LIST_ENTRY_CHECKS for wdf01000 3rd party code This PR is an accumulation of three peoples work, with the goal of the trying to get WDF to work like it should. This has been tested in combination with some extra NT6+ ntoskrnl against multiple drivers. --------- Co-authored-by: Max Korostil <[email protected]> Co-authored-by: Victor Perevertkin <[email protected]> Co-authored-by: Adam Słaboń <[email protected]> Co-authored-by: Hermès BÉLUSCA - MAÏTO <[email protected]>
147 lines
3.4 KiB
C++
147 lines
3.4 KiB
C++
/*++
|
|
|
|
Copyright (c) Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
FxUserObjectApi.cpp
|
|
|
|
Abstract:
|
|
|
|
This modules implements the C API's for the FxUserObject.
|
|
|
|
Author:
|
|
|
|
|
|
|
|
Environment:
|
|
|
|
Both kernel and user mode
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
#include "fxobjectpch.hpp"
|
|
|
|
#include "fxuserobject.hpp"
|
|
|
|
// Tracing support
|
|
extern "C" {
|
|
#if defined(EVENT_TRACING)
|
|
#include "FxUserObjectApi.tmh"
|
|
#endif
|
|
}
|
|
|
|
|
|
extern "C" {
|
|
|
|
_Must_inspect_result_
|
|
__drv_maxIRQL(DISPATCH_LEVEL)
|
|
NTSTATUS
|
|
NTAPI
|
|
WDFEXPORT(WdfObjectCreate)(
|
|
__in
|
|
PWDF_DRIVER_GLOBALS DriverGlobals,
|
|
__in_opt
|
|
PWDF_OBJECT_ATTRIBUTES Attributes,
|
|
__out
|
|
WDFOBJECT* Object
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This creates a general WDF object for use by the device driver.
|
|
|
|
It participates in general framework object contracts in that it:
|
|
|
|
- Has a handle and a reference count
|
|
- Has Cleanup and Destroy callbacks
|
|
- Supports driver context memory and type
|
|
- Can have child objects
|
|
- Can optionally have a parent object and automatically delete with it
|
|
|
|
It is intended to allow a WDF device driver to use this object to
|
|
create its own structures that can participate in frameworks lifetime
|
|
management.
|
|
|
|
The device driver can use the objects context memory and type to
|
|
represent its own internal data structures, and can further assign
|
|
device driver specific resources and release them by registering
|
|
for EvtObjectCleanup, and EvtObjectDestroy callbacks.
|
|
|
|
The object may be deleted by using the WdfObjectDelete API.
|
|
|
|
Since the object is represented by a frameworks handle, it can be
|
|
reference counted, and validated.
|
|
|
|
Class drivers may use this object to define framework object handles
|
|
for their types.
|
|
|
|
Arguments:
|
|
|
|
Attributes - WDF_OBJECT_ATTRIBUTES to define a parent object, context memory,
|
|
Cleanup and Destroy handlers.
|
|
|
|
Return Value:
|
|
|
|
NTSTATUS
|
|
|
|
--*/
|
|
|
|
{
|
|
DDI_ENTRY();
|
|
|
|
NTSTATUS status;
|
|
WDFOBJECT handle;
|
|
FxUserObject* pUserObject;
|
|
PFX_DRIVER_GLOBALS pFxDriverGlobals;
|
|
|
|
pUserObject = NULL;
|
|
pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals);
|
|
|
|
//
|
|
// Get the parent's globals if it is present
|
|
//
|
|
if (NT_SUCCESS(FxValidateObjectAttributesForParentHandle(pFxDriverGlobals,
|
|
Attributes))) {
|
|
FxObject* pParent;
|
|
|
|
FxObjectHandleGetPtrAndGlobals(pFxDriverGlobals,
|
|
Attributes->ParentObject,
|
|
FX_TYPE_OBJECT,
|
|
(PVOID*)&pParent,
|
|
&pFxDriverGlobals);
|
|
}
|
|
|
|
FxPointerNotNull(pFxDriverGlobals, Object);
|
|
|
|
status = FxValidateObjectAttributes(pFxDriverGlobals,
|
|
Attributes,
|
|
FX_VALIDATE_OPTION_EXECUTION_LEVEL_ALLOWED
|
|
);
|
|
if (!NT_SUCCESS(status)) {
|
|
return status;
|
|
}
|
|
|
|
//
|
|
// Create the FxObject.
|
|
//
|
|
status = FxUserObject::_Create(pFxDriverGlobals, Attributes, &pUserObject);
|
|
if (NT_SUCCESS(status)) {
|
|
handle = pUserObject->GetHandle();
|
|
*Object = handle;
|
|
|
|
DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_VERBOSE,
|
|
TRACINGUSEROBJECT,
|
|
"Created UserObject Handle 0x%p",
|
|
handle);
|
|
}
|
|
|
|
return status;
|
|
}
|
|
|
|
} // extern "C" the entire file
|