report.c File Reference

#include "iop.h"

Go to the source code of this file.

Defines
#define	DBG_AR   0
Functions
BOOLEAN	IopChangeInterfaceType (IN OUT PIO_RESOURCE_REQUIREMENTS_LIST IoResources, IN OUT PCM_RESOURCE_LIST *AllocatedResource)
VOID	IopInitializeResourceMap (PLOADER_PARAMETER_BLOCK LoaderBlock)
NTSTATUS	IoReportHalResourceUsage (IN PUNICODE_STRING HalName, IN PCM_RESOURCE_LIST RawResourceList, IN PCM_RESOURCE_LIST TranslatedResourceList, IN ULONG ResourceListSize)
NTSTATUS	IoReportResourceForDetection (IN PDRIVER_OBJECT DriverObject, IN PCM_RESOURCE_LIST DriverList OPTIONAL, IN ULONG DriverListSize OPTIONAL, IN PDEVICE_OBJECT DeviceObject OPTIONAL, IN PCM_RESOURCE_LIST DeviceList OPTIONAL, IN ULONG DeviceListSize OPTIONAL, OUT PBOOLEAN ConflictDetected)
NTSTATUS	IoReportResourceUsage (IN PUNICODE_STRING DriverClassName OPTIONAL, IN PDRIVER_OBJECT DriverObject, IN PCM_RESOURCE_LIST DriverList OPTIONAL, IN ULONG DriverListSize OPTIONAL, IN PDEVICE_OBJECT DeviceObject OPTIONAL, IN PCM_RESOURCE_LIST DeviceList OPTIONAL, IN ULONG DeviceListSize OPTIONAL, IN BOOLEAN OverrideConflict, OUT PBOOLEAN ConflictDetected)
NTSTATUS	IoReportResourceUsageInternal (IN ARBITER_REQUEST_SOURCE AllocationType, IN PUNICODE_STRING DriverClassName OPTIONAL, IN PDRIVER_OBJECT DriverObject, IN PCM_RESOURCE_LIST DriverList OPTIONAL, IN ULONG DriverListSize OPTIONAL, IN PDEVICE_OBJECT DeviceObject OPTIONAL, IN PCM_RESOURCE_LIST DeviceList OPTIONAL, IN ULONG DeviceListSize OPTIONAL, IN BOOLEAN OverrideConflict, OUT PBOOLEAN ConflictDetected)
NTSTATUS	IopWriteResourceList (HANDLE ResourceMapKey, PUNICODE_STRING ClassName, PUNICODE_STRING DriverName, PUNICODE_STRING DeviceName, PCM_RESOURCE_LIST ResourceList, ULONG ResourceListSize)
VOID	IopDumpCmResourceDescriptor (IN PUCHAR Indent, IN PCM_PARTIAL_RESOURCE_DESCRIPTOR Desc)
VOID	IopDumpCmResourceList (IN PCM_RESOURCE_LIST CmList)
Variables
WCHAR	IopWstrRaw []
WCHAR	IopWstrTranslated []
WCHAR	IopWstrBusTranslated []
WCHAR	IopWstrOtherDrivers []
WCHAR	IopWstrHal []
WCHAR	IopWstrSystem []
WCHAR	IopWstrPhysicalMemory []
WCHAR	IopWstrSpecialMemory []

---

Define Documentation

#define DBG_AR   0

Definition at line 29 of file report.c.

---

Function Documentation

BOOLEAN IopChangeInterfaceType (  IN OUT PIO_RESOURCE_REQUIREMENTS_LIST  IoResources, IN OUT PCM_RESOURCE_LIST *  AllocatedResource )

Definition at line 629 of file report.c. References ASSERT, CmResourceTypeReserved, ExAllocatePool, FALSE, IopDetermineResourceListSize(), NULL, PagedPool, PnpDefaultInterfaceType, and TRUE. Referenced by IoReportResourceUsageInternal(). 00636 : 00637 00638 This routine takes an Io resourcelist and changes its interfacetype 00639 from internal to default type (isa or eisa or mca). 00640 00641 Arguments: 00642 00643 IoResources - Pointer to requirement list. 00644 00645 AllocatedResources - Pointer to a variable that receives the pointer to the resource list. 00646 00647 Return Value: 00648 00649 BOOLEAN value to indicates if change made or not. 00650 00651 --*/ 00652 00653 { 00654 PIO_RESOURCE_LIST IoResourceList; 00655 PIO_RESOURCE_DESCRIPTOR IoResourceDescriptor; 00656 PIO_RESOURCE_DESCRIPTOR IoResourceDescriptorEnd; 00657 LONG IoResourceListCount; 00658 BOOLEAN changed; 00659 00660 ASSERT(AllocatedResources); 00661 00662 changed = FALSE; 00663 00664 if (!IoResources) { 00665 00666 return changed; 00667 00668 } 00669 00670 if (IoResources->InterfaceType == Internal) { 00671 00672 IoResources->InterfaceType = PnpDefaultInterfaceType; 00673 changed = TRUE; 00674 00675 } 00676 00677 IoResourceList = IoResources->List; 00678 IoResourceListCount = IoResources->AlternativeLists; 00679 while (--IoResourceListCount >= 0) { 00680 00681 IoResourceDescriptor = IoResourceList->Descriptors; 00682 IoResourceDescriptorEnd = IoResourceDescriptor + IoResourceList->Count; 00683 00684 for (;IoResourceDescriptor < IoResourceDescriptorEnd; IoResourceDescriptor++) { 00685 00686 if (IoResourceDescriptor->Type == CmResourceTypeReserved && 00687 IoResourceDescriptor->u.DevicePrivate.Data[0] == Internal) { 00688 00689 IoResourceDescriptor->u.DevicePrivate.Data[0] = PnpDefaultInterfaceType; 00690 changed = TRUE; 00691 00692 } 00693 } 00694 IoResourceList = (PIO_RESOURCE_LIST) IoResourceDescriptorEnd; 00695 } 00696 00697 if (changed) { 00698 00699 PCM_RESOURCE_LIST oldResources = *AllocatedResources; 00700 PCM_RESOURCE_LIST newResources; 00701 PCM_FULL_RESOURCE_DESCRIPTOR cmFullDesc; 00702 PCM_PARTIAL_RESOURCE_DESCRIPTOR cmPartDesc; 00703 ULONG size; 00704 00705 if (oldResources) { 00706 00707 size = IopDetermineResourceListSize(oldResources); 00708 newResources = ExAllocatePool(PagedPool, size); 00709 if (newResources == NULL) { 00710 00711 changed = FALSE; 00712 00713 } else { 00714 00715 ULONG i; 00716 ULONG j; 00717 00718 00719 RtlCopyMemory(newResources, oldResources, size); 00720 00721 // 00722 // Fix up the interface type 00723 // 00724 00725 cmFullDesc = &newResources->List[0]; 00726 for (i = 0; i < oldResources->Count; i++) { 00727 00728 if (cmFullDesc->InterfaceType == Internal) { 00729 00730 cmFullDesc->InterfaceType = PnpDefaultInterfaceType; 00731 00732 } 00733 cmPartDesc = &cmFullDesc->PartialResourceList.PartialDescriptors[0]; 00734 for (j = 0; j < cmFullDesc->PartialResourceList.Count; j++) { 00735 00736 size = 0; 00737 switch (cmPartDesc->Type) { 00738 00739 case CmResourceTypeDeviceSpecific: 00740 size = cmPartDesc->u.DeviceSpecificData.DataSize; 00741 break; 00742 00743 } 00744 cmPartDesc++; 00745 cmPartDesc = (PCM_PARTIAL_RESOURCE_DESCRIPTOR) ((PUCHAR)cmPartDesc + size); 00746 } 00747 00748 cmFullDesc = (PCM_FULL_RESOURCE_DESCRIPTOR)cmPartDesc; 00749 } 00750 00751 *AllocatedResources = newResources; 00752 } 00753 } 00754 } 00755 00756 return changed; 00757 }

VOID IopDumpCmResourceDescriptor (  IN PUCHAR  Indent, IN PCM_PARTIAL_RESOURCE_DESCRIPTOR  Desc )

Definition at line 868 of file report.c. References DbgPrint, and PAGED_CODE. Referenced by IopDumpCmResourceList(). 00874 : 00875 00876 This routine processes a IO_RESOURCE_DESCRIPTOR and displays it. 00877 00878 Arguments: 00879 00880 Indent - # char of indentation. 00881 00882 Desc - supplies a pointer to the IO_RESOURCE_DESCRIPTOR to be displayed. 00883 00884 Return Value: 00885 00886 None. 00887 00888 --*/ 00889 { 00890 PAGED_CODE(); 00891 00892 switch (Desc->Type) { 00893 case CmResourceTypePort: 00894 DbgPrint ("%sIO Start: %x:%08x, Length: %x\n", 00895 Indent, 00896 Desc->u.Port.Start.HighPart, Desc->u.Port.Start.LowPart, 00897 Desc->u.Port.Length 00898 ); 00899 break; 00900 00901 case CmResourceTypeMemory: 00902 DbgPrint ("%sMEM Start: %x:%08x, Length: %x\n", 00903 Indent, 00904 Desc->u.Memory.Start.HighPart, Desc->u.Memory.Start.LowPart, 00905 Desc->u.Memory.Length 00906 ); 00907 break; 00908 00909 case CmResourceTypeInterrupt: 00910 DbgPrint ("%sINT Level: %x, Vector: %x, Affinity: %x\n", 00911 Indent, 00912 Desc->u.Interrupt.Level, 00913 Desc->u.Interrupt.Vector, 00914 Desc->u.Interrupt.Affinity 00915 ); 00916 break; 00917 00918 case CmResourceTypeDma: 00919 DbgPrint ("%sDMA Channel: %x, Port: %x\n", 00920 Indent, 00921 Desc->u.Dma.Channel, 00922 Desc->u.Dma.Port 00923 ); 00924 break; 00925 } 00926 }

VOID IopDumpCmResourceList (  IN PCM_RESOURCE_LIST  CmList  )

Definition at line 929 of file report.c. References DbgPrint, IopDumpCmResourceDescriptor(), and PAGED_CODE. Referenced by IopBuildCmResourceLists(), and IopReserveLegacyBootResources(). 00934 : 00935 00936 This routine displays CM resource list. 00937 00938 Arguments: 00939 00940 CmList - supplies a pointer to CM resource list 00941 00942 Return Value: 00943 00944 None. 00945 00946 --*/ 00947 { 00948 PCM_FULL_RESOURCE_DESCRIPTOR fullDesc; 00949 PCM_PARTIAL_RESOURCE_LIST partialDesc; 00950 PCM_PARTIAL_RESOURCE_DESCRIPTOR desc; 00951 ULONG count, i; 00952 00953 PAGED_CODE(); 00954 00955 if (CmList->Count > 0) { 00956 if (CmList) { 00957 fullDesc = &CmList->List[0]; 00958 DbgPrint("Cm Resource List -\n"); 00959 DbgPrint(" List Count = %x, Bus Number = %x\n", CmList->Count, fullDesc->BusNumber); 00960 partialDesc = &fullDesc->PartialResourceList; 00961 DbgPrint(" Version = %x, Revision = %x, Desc count = %x\n", partialDesc->Version, 00962 partialDesc->Revision, partialDesc->Count); 00963 count = partialDesc->Count; 00964 desc = &partialDesc->PartialDescriptors[0]; 00965 for (i = 0; i < count; i++) { 00966 IopDumpCmResourceDescriptor(" ", desc); 00967 desc++; 00968 } 00969 } 00970 } 00971 } //#endif

VOID IopInitializeResourceMap (  PLOADER_PARAMETER_BLOCK  LoaderBlock  )

Definition at line 66 of file report.c. References _PHYSICAL_MEMORY_RUN::BasePage, CmRegistryMachineHardwareResourceMapName, ExAllocatePool, ExFreePool(), FALSE, IopOpenRegistryKey(), IopWriteResourceList(), IopWstrPhysicalMemory, IopWstrSpecialMemory, IopWstrSystem, IopWstrTranslated, LoaderMaximum, LoaderSpecialMemory, MAX_PHYSICAL_MEMORY_FRAGMENTS, MmInitializeMemoryLimits(), MmPhysicalMemoryBlock, NT_SUCCESS, NTSTATUS(), NULL, _PHYSICAL_MEMORY_DESCRIPTOR::NumberOfRuns, PAGE_SHIFT, _PHYSICAL_MEMORY_RUN::PageCount, PagedPool, RtlInitUnicodeString(), _PHYSICAL_MEMORY_DESCRIPTOR::Run, and TRUE. Referenced by IoInitSystem(). { ULONG i, j, pass, length; LARGE_INTEGER li; HANDLE keyHandle; UNICODE_STRING unicodeString, systemString, listString; NTSTATUS status; PCM_RESOURCE_LIST ResourceList; PCM_PARTIAL_RESOURCE_DESCRIPTOR CmDescriptor; BOOLEAN IncludeType[LoaderMaximum]; ULONG MemoryAlloc[(sizeof(PHYSICAL_MEMORY_DESCRIPTOR) + sizeof(PHYSICAL_MEMORY_RUN)*MAX_PHYSICAL_MEMORY_FRAGMENTS) / sizeof(ULONG)]; PPHYSICAL_MEMORY_DESCRIPTOR MemoryBlock; RtlInitUnicodeString( &systemString, IopWstrSystem); RtlInitUnicodeString( &listString, IopWstrTranslated ); for (pass=0; pass < 2; pass++) { switch (pass) { case 0: // // Add MmPhysicalMemoryBlock to regitry // RtlInitUnicodeString( &unicodeString, IopWstrPhysicalMemory); MemoryBlock = MmPhysicalMemoryBlock; break; case 1: // // Add LoadSpecialMemory to registry // RtlInitUnicodeString( &unicodeString, IopWstrSpecialMemory); // // Computer memory limits of LoaderSpecialMemory // MemoryBlock = (PPHYSICAL_MEMORY_DESCRIPTOR)&MemoryAlloc; MemoryBlock->NumberOfRuns = MAX_PHYSICAL_MEMORY_FRAGMENTS; for (j=0; j < LoaderMaximum; j++) { IncludeType[j] = FALSE; } IncludeType[LoaderSpecialMemory] = TRUE; MmInitializeMemoryLimits( LoaderBlock, IncludeType, MemoryBlock ); break; } // // Allocate and build a CM_RESOURCE_LIST to describe all // of physical memory // j = MemoryBlock->NumberOfRuns; if (j == 0) { continue; } length = sizeof(CM_RESOURCE_LIST) + (j-1) * sizeof (CM_PARTIAL_RESOURCE_DESCRIPTOR); ResourceList = (PCM_RESOURCE_LIST) ExAllocatePool (PagedPool, length); if (!ResourceList) { return; } RtlZeroMemory ((PVOID) ResourceList, length); ResourceList->Count = 1; ResourceList->List[0].PartialResourceList.Count = j; CmDescriptor = ResourceList->List[0].PartialResourceList.PartialDescriptors; for (i=0; i < j; i++) { CmDescriptor->Type = CmResourceTypeMemory; CmDescriptor->ShareDisposition = CmResourceShareDeviceExclusive; li.QuadPart = (LONGLONG)(MemoryBlock->Run[i].BasePage); li.QuadPart <<= PAGE_SHIFT; CmDescriptor->u.Memory.Start = li; // fixfix - handle page frame numbers greater than 32 bits. CmDescriptor->u.Memory.Length = (ULONG)(MemoryBlock->Run[i].PageCount << PAGE_SHIFT); CmDescriptor++; } // // Add the resoruce list to the resorucemap // status = IopOpenRegistryKey( &keyHandle, (HANDLE) NULL, &CmRegistryMachineHardwareResourceMapName, KEY_READ | KEY_WRITE, TRUE ); if (NT_SUCCESS( status )) { IopWriteResourceList ( keyHandle, &systemString, &unicodeString, &listString, ResourceList, length ); ZwClose( keyHandle ); } ExFreePool (ResourceList); } }

NTSTATUS IopWriteResourceList (  HANDLE  ResourceMapKey, PUNICODE_STRING  ClassName, PUNICODE_STRING  DriverName, PUNICODE_STRING  DeviceName, PCM_RESOURCE_LIST  ResourceList, ULONG  ResourceListSize )

Definition at line 760 of file report.c. References IopOpenRegistryKey(), L, NT_SUCCESS, NTSTATUS(), PAGED_CODE, and TRUE. Referenced by IopBuildCmResourceList(), IopInitializeResourceMap(), and IoReportHalResourceUsage(). 00771 : 00772 00773 This routine takes a resourcelist and stores it in the registry resource 00774 map, using the ClassName, DriverName and DeviceName as the path of the 00775 key to store it in. 00776 00777 Arguments: 00778 00779 ResourceMapKey - Handle to the root of the resource map. 00780 00781 ClassName - Pointer to a Unicode String that contains the name of the Class 00782 for this resource list. 00783 00784 DriverName - Pointer to a Unicode String that contains the name of the 00785 Driver for this resource list. 00786 00787 DeviceName - Pointer to a Unicode String that contains the name of the 00788 Device for this resource list. 00789 00790 ResourceList - P to the resource list. 00791 00792 ResourceListSize - Value determining the size of the resource list. 00793 00794 Return Value: 00795 00796 The status returned is the final completion status of the operation. 00797 00798 --*/ 00799 00800 00801 { 00802 NTSTATUS status; 00803 HANDLE classKeyHandle; 00804 HANDLE driverKeyHandle; 00805 00806 PAGED_CODE(); 00807 00808 status = IopOpenRegistryKey( &classKeyHandle, 00809 ResourceMapKey, 00810 ClassName, 00811 KEY_READ | KEY_WRITE, 00812 TRUE ); 00813 00814 if (NT_SUCCESS( status )) { 00815 00816 // 00817 // Take the resulting name to create the key. 00818 // 00819 00820 status = IopOpenRegistryKey( &driverKeyHandle, 00821 classKeyHandle, 00822 DriverName, 00823 KEY_READ | KEY_WRITE, 00824 TRUE ); 00825 00826 ZwClose( classKeyHandle ); 00827 00828 00829 if (NT_SUCCESS( status )) { 00830 00831 // 00832 // With this key handle, we can now store the required information 00833 // in the value entries of the key. 00834 // 00835 00836 // 00837 // Store the device name as a value name and the device information 00838 // as the rest of the data. 00839 // Only store the information if the CM_RESOURCE_LIST was present. 00840 // 00841 00842 if (ResourceList->Count == 0) { 00843 00844 status = ZwDeleteValueKey( driverKeyHandle, 00845 DeviceName ); 00846 00847 } else { 00848 00849 status = ZwSetValueKey( driverKeyHandle, 00850 DeviceName, 00851 0L, 00852 REG_RESOURCE_LIST, 00853 ResourceList, 00854 ResourceListSize ); 00855 00856 } 00857 00858 ZwClose( driverKeyHandle ); 00859 00860 } 00861 } 00862 00863 return status; 00864 } //#if DBG

NTSTATUS IoReportHalResourceUsage (  IN PUNICODE_STRING  HalName, IN PCM_RESOURCE_LIST  RawResourceList, IN PCM_RESOURCE_LIST  TranslatedResourceList, IN ULONG  ResourceListSize )

Definition at line 193 of file report.c. References CmRegistryMachineHardwareResourceMapName, ExAllocatePool, IopInitHalResources, IopOpenRegistryKey(), IopWriteResourceList(), IopWstrHal, IopWstrRaw, IopWstrTranslated, NT_SUCCESS, NTSTATUS(), NULL, PAGED_CODE, PagedPool, RtlInitUnicodeString(), and TRUE. 00202 : 00203 00204 This routine is called by the HAL to report its resources. 00205 The Hal is the first component to report its resources, so we don't need 00206 to acquire the resourcemap semaphore, and we do not need to check for 00207 conflicts. 00208 00209 Arguments: 00210 00211 HalName - Name of the HAL reporting the resources. 00212 00213 RawResourceList - Pointer to the HAL's raw resource list. 00214 00215 TranslatedResourceList - Pointer to the HAL's translated resource list. 00216 00217 DriverListSize - Value determining the size of the HAL's resource list. 00218 00219 Return Value: 00220 00221 The status returned is the final completion status of the operation. 00222 00223 --*/ 00224 00225 { 00226 HANDLE keyHandle; 00227 UNICODE_STRING halString; 00228 UNICODE_STRING listString; 00229 NTSTATUS status; 00230 00231 PAGED_CODE(); 00232 00233 // 00234 // First open a handle to the RESOURCEMAP key. 00235 // 00236 00237 RtlInitUnicodeString( &halString, IopWstrHal ); 00238 00239 status = IopOpenRegistryKey( &keyHandle, 00240 (HANDLE) NULL, 00241 &CmRegistryMachineHardwareResourceMapName, 00242 KEY_READ | KEY_WRITE, 00243 TRUE ); 00244 00245 // 00246 // Write out the raw resource list 00247 // 00248 00249 if (NT_SUCCESS( status )) { 00250 00251 RtlInitUnicodeString( &listString, IopWstrRaw); 00252 00253 status = IopWriteResourceList( keyHandle, 00254 &halString, 00255 HalName, 00256 &listString, 00257 RawResourceList, 00258 ResourceListSize ); 00259 00260 // 00261 // If we successfully wrote out the raw resource list, write out 00262 // the translated resource list. 00263 // 00264 00265 if (NT_SUCCESS( status )) { 00266 00267 RtlInitUnicodeString( &listString, IopWstrTranslated); 00268 status = IopWriteResourceList( keyHandle, 00269 &halString, 00270 HalName, 00271 &listString, 00272 TranslatedResourceList, 00273 ResourceListSize ); 00274 00275 } 00276 ZwClose( keyHandle ); 00277 } 00278 00279 // 00280 // If every looks fine, we will make a copy of the Hal resources so will 00281 // can call Arbiters to reserve the resources after they initialized. 00282 // 00283 00284 if (NT_SUCCESS(status)) { 00285 IopInitHalResources = (PCM_RESOURCE_LIST) ExAllocatePool(PagedPool, ResourceListSize); 00286 if (IopInitHalResources) { 00287 RtlMoveMemory(IopInitHalResources, RawResourceList, ResourceListSize); 00288 } else { 00289 status = STATUS_INSUFFICIENT_RESOURCES; 00290 } 00291 } 00292 00293 return status; 00294 }

NTSTATUS IoReportResourceForDetection (  IN PDRIVER_OBJECT  DriverObject, IN PCM_RESOURCE_LIST DriverList  OPTIONAL, IN ULONG DriverListSize  OPTIONAL, IN PDEVICE_OBJECT DeviceObject  OPTIONAL, IN PCM_RESOURCE_LIST DeviceList  OPTIONAL, IN ULONG DeviceListSize  OPTIONAL, OUT PBOOLEAN  ConflictDetected )

Definition at line 297 of file report.c. References ArbiterRequestPnpDetected, DNF_LEGACY_RESOURCE_DEVICENODE, FALSE, IoReportResourceUsageInternal(), KeBugCheckEx(), NULL, and PNP_ERR_INVALID_PDO. : This routine will automatically search through the configuration registry for resource conflicts between resources requested by a device and the resources already claimed by previously installed drivers. The contents of the DriverList and the DeviceList will be matched against all the other resource list stored in the registry to determine conflicts. The function may be called more than once for a given device or driver. If a new resource list is given, the previous resource list stored in the registry will be replaced by the new list. Note, this function is for the drivers acquiring resources for detection. Arguments: DriverObject - Pointer to the driver's driver object. DriverList - Optional pointer to the driver's resource list. DriverListSize - Optional value determining the size of the driver's resource list. DeviceObject - Optional pointer to driver's device object. DeviceList - Optional pointer to the device's resource list. DriverListSize - Optional value determining the size of the device's resource list. ConflictDetected - Supplies a pointer to a boolean that is set to TRUE if the resource list conflicts with an already existing resource list in the configuration registry. Return Value: The status returned is the final completion status of the operation. --*/ { // // Sanity check that the caller did not pass in a PnP PDO. // if (DeviceObject) { if ( DeviceObject->DeviceObjectExtension->DeviceNode && !(((PDEVICE_NODE)DeviceObject->DeviceObjectExtension->DeviceNode)->Flags & DNF_LEGACY_RESOURCE_DEVICENODE)) { KeBugCheckEx(PNP_DETECTED_FATAL_ERROR, PNP_ERR_INVALID_PDO, (ULONG_PTR)DeviceObject, 0, 0); } } return IoReportResourceUsageInternal( ArbiterRequestPnpDetected, NULL, DriverObject, DriverList, DriverListSize, DeviceObject, DeviceList, DeviceListSize, FALSE, ConflictDetected); }

NTSTATUS IoReportResourceUsage (  IN PUNICODE_STRING DriverClassName  OPTIONAL, IN PDRIVER_OBJECT  DriverObject, IN PCM_RESOURCE_LIST DriverList  OPTIONAL, IN ULONG DriverListSize  OPTIONAL, IN PDEVICE_OBJECT DeviceObject  OPTIONAL, IN PCM_RESOURCE_LIST DeviceList  OPTIONAL, IN ULONG DeviceListSize  OPTIONAL, IN BOOLEAN  OverrideConflict, OUT PBOOLEAN  ConflictDetected )

Definition at line 379 of file report.c. References ArbiterRequestLegacyReported, DNF_LEGACY_RESOURCE_DEVICENODE, IoReportResourceUsageInternal(), KeBugCheckEx(), and PNP_ERR_INVALID_PDO. Referenced by DriverEntry(). 00393 : 00394 00395 This routine will automatically search through the configuration 00396 registry for resource conflicts between resources requested by a device 00397 and the resources already claimed by previously installed drivers. The 00398 contents of the DriverList and the DeviceList will be matched against 00399 all the other resource list stored in the registry to determine 00400 conflicts. 00401 00402 If not conflict was detected, or if the OverrideConflict flag is set, 00403 this routine will create appropriate entries in the system resource map 00404 (in the registry) that will contain the specified resource lists. 00405 00406 The function may be called more than once for a given device or driver. 00407 If a new resource list is given, the previous resource list stored in 00408 the registry will be replaced by the new list. 00409 00410 Arguments: 00411 00412 DriverClassName - Optional pointer to a UNICODE_STRING which describes 00413 the class of driver under which the driver information should be 00414 stored. A default type is used if none is given. 00415 00416 DriverObject - Pointer to the driver's driver object. 00417 00418 DriverList - Optional pointer to the driver's resource list. 00419 00420 DriverListSize - Optional value determining the size of the driver's 00421 resource list. 00422 00423 DeviceObject - Optional pointer to driver's device object. 00424 00425 DeviceList - Optional pointer to the device's resource list. 00426 00427 DriverListSize - Optional value determining the size of the driver's 00428 resource list. 00429 00430 OverrideConflict - Determines if the information should be reported 00431 in the configuration registry eventhough a conflict was found with 00432 another driver or device. 00433 00434 ConflictDetected - Supplies a pointer to a boolean that is set to TRUE 00435 if the resource list conflicts with an already existing resource 00436 list in the configuration registry. 00437 00438 Return Value: 00439 00440 The status returned is the final completion status of the operation. 00441 00442 --*/ 00443 00444 { 00445 if (DeviceObject) { 00446 00447 if ( DeviceObject->DeviceObjectExtension->DeviceNode && 00448 !(((PDEVICE_NODE)DeviceObject->DeviceObjectExtension->DeviceNode)->Flags & DNF_LEGACY_RESOURCE_DEVICENODE)) { 00449 00450 KeBugCheckEx(PNP_DETECTED_FATAL_ERROR, PNP_ERR_INVALID_PDO, (ULONG_PTR)DeviceObject, 0, 0); 00451 00452 } 00453 00454 } 00455 00456 return IoReportResourceUsageInternal( ArbiterRequestLegacyReported, 00457 DriverClassName, 00458 DriverObject, 00459 DriverList, 00460 DriverListSize, 00461 DeviceObject, 00462 DeviceList, 00463 DeviceListSize, 00464 OverrideConflict, 00465 ConflictDetected); 00466 }

NTSTATUS IoReportResourceUsageInternal (  IN ARBITER_REQUEST_SOURCE  AllocationType, IN PUNICODE_STRING DriverClassName  OPTIONAL, IN PDRIVER_OBJECT  DriverObject, IN PCM_RESOURCE_LIST DriverList  OPTIONAL, IN ULONG DriverListSize  OPTIONAL, IN PDEVICE_OBJECT DeviceObject  OPTIONAL, IN PCM_RESOURCE_LIST DeviceList  OPTIONAL, IN ULONG DeviceListSize  OPTIONAL, IN BOOLEAN  OverrideConflict, OUT PBOOLEAN  ConflictDetected )

Definition at line 469 of file report.c. References ASSERT, ExFreePool(), FALSE, IopChangeInterfaceType(), IopCmResourcesToIoResources(), IopLegacyResourceAllocation(), NT_SUCCESS, NTSTATUS(), NULL, and TRUE. Referenced by IoReportDetectedDevice(), IoReportResourceForDetection(), and IoReportResourceUsage(). 00484 : 00485 00486 This internal routine will do all the work for IoReportResourceUsage. 00487 00488 Arguments: 00489 00490 AllocationType - Specifies the request type. 00491 00492 DriverClassName - Optional pointer to a UNICODE_STRING which describes 00493 the class of driver under which the driver information should be 00494 stored. A default type is used if none is given. 00495 00496 DriverObject - Pointer to the driver's driver object. 00497 00498 DriverList - Optional pointer to the driver's resource list. 00499 00500 DriverListSize - Optional value determining the size of the driver's 00501 resource list. 00502 00503 DeviceObject - Optional pointer to driver's device object. 00504 00505 DeviceList - Optional pointer to the device's resource list. 00506 00507 DriverListSize - Optional value determining the size of the driver's 00508 resource list. 00509 00510 OverrideConflict - Determines if the information should be reported 00511 in the configuration registry eventhough a conflict was found with 00512 another driver or device. 00513 00514 ConflictDetected - Supplies a pointer to a boolean that is set to TRUE 00515 if the resource list conflicts with an already existing resource 00516 list in the configuration registry. 00517 00518 Return Value: 00519 00520 The status returned is the final completion status of the operation. 00521 00522 --*/ 00523 00524 { 00525 NTSTATUS status = STATUS_UNSUCCESSFUL; 00526 PCM_RESOURCE_LIST resourceList; 00527 PCM_RESOURCE_LIST allocatedResources; 00528 PIO_RESOURCE_REQUIREMENTS_LIST resourceRequirements; 00529 ULONG attempt; 00530 BOOLEAN freeAllocatedResources; 00531 00532 ASSERT(DriverObject && ConflictDetected); 00533 00534 if (DeviceList) { 00535 00536 resourceList = DeviceList; 00537 00538 } else if (DriverList) { 00539 00540 resourceList = DriverList; 00541 00542 } else { 00543 00544 resourceList = NULL; 00545 00546 } 00547 00548 resourceRequirements = NULL; 00549 00550 if (resourceList) { 00551 00552 if (resourceList->Count && resourceList->List[0].PartialResourceList.Count) { 00553 00554 resourceRequirements = IopCmResourcesToIoResources (0, resourceList, LCPRI_NORMAL); 00555 00556 if (resourceRequirements == NULL) { 00557 00558 return status; 00559 00560 } 00561 00562 } else { 00563 00564 resourceList = NULL; 00565 00566 } 00567 00568 } 00569 00570 *ConflictDetected = TRUE; 00571 attempt = 0; 00572 allocatedResources = resourceList; 00573 freeAllocatedResources = FALSE; 00574 do { 00575 00576 // 00577 // Do the legacy resource allocation. 00578 // 00579 00580 status = IopLegacyResourceAllocation ( AllocationType, 00581 DriverObject, 00582 DeviceObject, 00583 resourceRequirements, 00584 &allocatedResources); 00585 00586 if (NT_SUCCESS(status)) { 00587 00588 *ConflictDetected = FALSE; 00589 break; 00590 } 00591 00592 // 00593 // Change the interface type and try again. 00594 // 00595 00596 if (!IopChangeInterfaceType(resourceRequirements, &allocatedResources)) { 00597 00598 break; 00599 } 00600 freeAllocatedResources = TRUE; 00601 00602 } while (++attempt < 2); 00603 00604 if (resourceRequirements) { 00605 00606 ExFreePool(resourceRequirements); 00607 00608 } 00609 00610 if (freeAllocatedResources) { 00611 00612 ExFreePool(allocatedResources); 00613 } 00614 00615 if (NT_SUCCESS(status)) { 00616 00617 status = STATUS_SUCCESS; 00618 00619 } else { 00620 00621 status = STATUS_INSUFFICIENT_RESOURCES; 00622 00623 } 00624 00625 return status; 00626 }

---

Variable Documentation

WCHAR IopWstrBusTranslated[]

Definition at line 33 of file report.c.

WCHAR IopWstrHal[]

Definition at line 36 of file report.c. Referenced by IoReportHalResourceUsage().

WCHAR IopWstrOtherDrivers[]

Definition at line 34 of file report.c.

WCHAR IopWstrPhysicalMemory[]

Definition at line 38 of file report.c. Referenced by IopInitializeResourceMap().

WCHAR IopWstrRaw[]

Definition at line 31 of file report.c. Referenced by IopBuildCmResourceList(), and IoReportHalResourceUsage().

WCHAR IopWstrSpecialMemory[]

Definition at line 39 of file report.c. Referenced by IopInitializeResourceMap().

WCHAR IopWstrSystem[]

Definition at line 37 of file report.c. Referenced by IopInitializeResourceMap().

WCHAR IopWstrTranslated[]

Definition at line 32 of file report.c.

---