LONG
DrvSetDeviceIdParameter(
PREG_ACCESS RegAccess,
UINT DeviceNumber,
PTCHAR ValueName,
DWORD Value
);
The DrvSetDeviceIdParameter function assigns the specified value to the specified value name in the registry, under the specified device’s \Parameters key.
Parameters
RegAccess
Pointer to a globally-defined structure of type REG_ACCESS.
DeviceNumber
Device number. Used as an index to the device subkeys under the \Parameters key. See the Comments section below.
ValueName
Pointer to a string representing the value name.
Value
Value to be written.
Return Value
Returns ERROR_SUCCESS if the operation succeeds. Otherwise returns one of the error codes defined in winerror.h. See the Comments section below.
Comments
The structure pointed to by RegAccess must be a single, globally-defined REG_ACCESS structure that the driver uses with all calls to drvlib.lib functions requiring a RegAccess parameter.
Before a driver can call the DrvSetDeviceIdParameter function, it must call DrvCreateDeviceKey.
The value name and value are written to the registry path HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DriverName\Parameters\DeviceNumber, where Number represents the number supplied by the DeviceNumber parameter.
The specified value is stored as a REG_DWORD type.
The function calls RegSetValueEx, which is described in the Win32 SDK, and returns its return value.
To retrieve a registry value written with DrvSetDeviceIdParameter, call DrvQueryDeviceIdParameter.
Drivers must call DrvCreateServicesNode before calling DrvSetDeviceIdParameter.
For additional information, see Installing and Configuring your Driver, Using drvlib.lib.