Function_IRPMonDllClassWatchRegister

IRPMonDllClassWatchRegister function

Summary

Starts watching for devices (and their drivers) belonging to a given device setup class.

The IRPMon driver install itself as a lower or upper filter to the specified class. Thus, its AddDevice routine will be invoked when a new device of that class appears in the system.

Definition

void cdecl IRPMonDllClassWatchRegister(
    System.Char* ClassGuid,
    System.Byte UpperFilter,
    System.Byte Beginning
   );

Parameters

ClassGuid

GUID of the device setup class to monitor, in its string form.

UpperFilter

A boolean valu indicating whether the IRPMon driver should be installed as a lower or upper filter.

Beginning

Determines whether the IRPMon driver is installed as the first or the last of the class filters.

Return Value

Returns one of the following values:

Value	Description
ERROR_SUCCESS	The registration was successful
Other	An error occurred.

Remarks

The ability to watch for new devices and drivers of certain device setup class can be useful when tracking requests sent to a device shortly after its appearance. Use IRPMonDllDriverNameWatchRegister to automatically start monitoring a driver with specific name immediately after one of its devices is created and detected by the class watching capability of the IRPMon driver.

See also

• IRPMonDllDriverNameWatchRegister

Requirements

Header	irpmondll.h
Library	irpmondll.lib
DLL	irpmondll.dll