DrvLibInit

BOOL
    DrvLibInit(
        HINSTANCE hModule,
        ULONG Reason,
        PCONTEXT pContext
        );

The DrvLibInit function initializes drvlib.lib for use with the calling user-mode audio driver. User-mode audio drivers call this function before they begin calling other functions in drvlib.lib. They call the function again prior to being unloaded.

Parameters

hModule

Instance handle of the module that opened the user-mode driver. Obtained by calling GetDriverModuleHandle, which is described in the Win32 SDK.

Reason

Set to one of the following values.

• DLL_PROCESS_ATTACH, if attaching to drvlib.lib.

• DLL_PROCESS_DETACH, if detaching from drvlib.lib.

pContext

Not used. Should be set to NULL.

Return Value

Returns TRUE if the operation succeeds. Otherwise returns FALSE.

Comments

When the driver’s DriverProc function receives a DRV_LOAD message, it should call DrvLibInit with a Reason value of DLL_PROCESS_ATTACH.

When the driver’s DriverProc function receives a DRV_FREE message, it should call DrvLibInit with a Reason value of DLL_PROCESS_DETACH.

For additional information, see Installing and Configuring your Driver, Using drvlib.lib.