Interface Cfgmgr32

  • All Superinterfaces:
    Library

    public interface Cfgmgr32
    extends Library
    Windows Cfgmgr32.
    Author:
    widdis[at]gmail[dot]com
    • Method Detail

      • CM_Locate_DevNode

        int CM_Locate_DevNode​(IntByReference pdnDevInst,
                              String pDeviceID,
                              int ulFlags)
        The CM_Locate_DevNode function obtains a device instance handle to the device node that is associated with a specified device instance ID on the local machine.
        Parameters:
        pdnDevInst - A pointer to a device instance handle that CM_Locate_DevNode retrieves. The retrieved handle is bound to the local machine.
        pDeviceID - A pointer to a NULL-terminated string representing a device instance ID. If this value is NULL, or if it points to a zero-length string, the function retrieves a device instance handle to the device at the root of the device tree. *
        ulFlags - A variable of ULONG type that supplies one of the following flag values that apply if the caller supplies a device instance identifier: CM_LOCATE_DEVNODE_NORMAL, CM_LOCATE_DEVNODE_PHANTOM, CM_LOCATE_DEVNODE_CANCELREMOVE, or CM_LOCATE_DEVNODE_NOVALIDATION
        Returns:
        If the operation succeeds, CM_Locate_DevNode returns CR_SUCCESS. Otherwise, the function returns one of the CR_Xxx error codes that are defined in Cfgmgr32.h.
        See Also:
        CM_Locate_DevNode
      • CM_Get_Parent

        int CM_Get_Parent​(IntByReference pdnDevInst,
                          int dnDevInst,
                          int ulFlags)
        The CM_Get_Parent function obtains a device instance handle to the parent node of a specified device node (devnode) in the local machine's device tree.
        Parameters:
        pdnDevInst - Caller-supplied pointer to the device instance handle to the parent node that this function retrieves. The retrieved handle is bound to the local machine.
        dnDevInst - Caller-supplied device instance handle that is bound to the local machine.
        ulFlags - Not used, must be zero.
        Returns:
        If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
        See Also:
        CM_Get_Parent
      • CM_Get_Child

        int CM_Get_Child​(IntByReference pdnDevInst,
                         int dnDevInst,
                         int ulFlags)
        The CM_Get_Child function is used to retrieve a device instance handle to the first child node of a specified device node (devnode) in the local machine's device tree.
        Parameters:
        pdnDevInst - Caller-supplied pointer to the device instance handle to the child node that this function retrieves. The retrieved handle is bound to the local machine.
        dnDevInst - Caller-supplied device instance handle that is bound to the local machine.
        ulFlags - Not used, must be zero.
        Returns:
        If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
        See Also:
        CM_Get_Child
      • CM_Get_Sibling

        int CM_Get_Sibling​(IntByReference pdnDevInst,
                           int dnDevInst,
                           int ulFlags)
        The CM_Get_Sibling function obtains a device instance handle to the next sibling node of a specified device node (devnode) in the local machine's device tree.
        Parameters:
        pdnDevInst - Caller-supplied pointer to the device instance handle to the sibling node that this function retrieves. The retrieved handle is bound to the local machine.
        dnDevInst - Caller-supplied device instance handle that is bound to the local machine.
        ulFlags - Not used, must be zero.
        Returns:
        If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
        See Also:
        CM_Get_Sibling
      • CM_Get_Device_ID

        int CM_Get_Device_ID​(int devInst,
                             Pointer Buffer,
                             int BufferLen,
                             int ulFlags)
        The CM_Get_Device_ID function retrieves the device instance ID for a specified device instance on the local machine.
        Parameters:
        devInst - Caller-supplied device instance handle that is bound to the local machine.
        Buffer - Address of a buffer to receive a device instance ID string. The required buffer size can be obtained by calling CM_Get_Device_ID_Size, then incrementing the received value to allow room for the string's terminating NULL.
        BufferLen - Caller-supplied length, in characters, of the buffer specified by Buffer.
        ulFlags - Not used, must be zero.
        Returns:
        If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
        See Also:
        CM_Get_Device_ID
      • CM_Get_Device_ID_Size

        int CM_Get_Device_ID_Size​(IntByReference pulLen,
                                  int dnDevInst,
                                  int ulFlags)
        The CM_Get_Device_ID_Size function retrieves the buffer size required to hold a device instance ID for a device instance on the local machine.
        Parameters:
        pulLen - Receives a value representing the required buffer size, in characters.
        dnDevInst - Caller-supplied device instance handle that is bound to the local machine.
        ulFlags - Not used, must be zero.
        Returns:
        If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.
        See Also:
        CM_Get_Device_ID_Size