How To Use Configuration Manager to Get Free Resource Info

• Microsoft Win32 Device Driver Kit (DDK) for Windows 95, version 4.0

SUMMARY

This article describes how to obtain free resource information on memory, IO, DMA, and IRQ in Windows 95 by using the CONFIGMG_Query_Arbitrator_Free_Data function. The following information is based on documentation from the Windows 95 Device Driver Programmer's Reference, with additional information added for completeness:

CONFIGRET CONFIGMG_Query_Arbitrator_Free_Data(PFARVOID pData, ULONG DataLen, DEVNODE dnDevNode, RESOURCEID ResourceID, ULONG ulFlags)

MORE INFORMATION

Return Value

Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_BUFFER_SMALL, CR_FAILURE, CR_INVALID_DEVNODE, CR_INVALID_FLAG, CR_INVALID_POINTER, CR_INVALID_RESOURCEID or CR_NO_ARBITRATOR.

Parameters

pData:

   Address of a buffer that receives the free information. This information
   is arbitrator-specific. The buffer can be of type MEMA_ARB, IOA_ARB,
   DMA_ARB, and IRQ_ARB. See the \ddk\inc32\configmg.h header file for more
   information on these structure types.

   The size (in bytes) of the data buffer.  Use the
   CONFIGMG_Query_Arbitrator_Free_Size function to obtain the correct
   size for the buffer.

   Device node associated with the arbitrator. This is most meaningful for
   local arbitrators. (Although any device node can be used for global
   arbitrators, this parameter should specify the root or NULL in that
   case.)

   One of the resource identifiers listed in the ResourceId parameter of
   the CONFIGMG_Add_Res_Des function. This function returns
   CR_INVALID_RESOURCEID if this value is ResType_All or ResType_None.

   Must be zero.

   This function succeeds even when it returns CR_BUFFER_SMALL. To avoid
   this error, call CONFIGMG_Query_Arbitrator_Free_Size before calling this
   function.

   You need to call Configuration Manager functions using the correct
   naming scheme. The function names should begin with CM_, not CONFIGMG_.

REFERENCES

See the Windows 95 DDK for more information on Configuration Manager and Plug and Play.