SOUND_EXCLUDE_ROUTINE

typedef BOOLEAN SOUND_EXCLUDE_ROUTINE(struct _LOCAL_DEVICE_INFO *, SOUND_EXCLUDE_CODE);

SOUND_EXCLUDE_ROUTINE is a type definition for routines that handle mutual exclusion operations.

Parameters

_LOCAL_DEVICE_INFO*

Type for a pointer to a LOCAL_DEVICE_INFO structure.

SOUND_EXCLUDE_CODE

Type for a code indicating the type of exclusion operation the routine should handle. See SOUND_EXCLUDE_CODE for the type's definition.

Comments

Drivers using soundlib.lib define a function modeled on this type and place its address in the ExclusionRoutine member of a SOUND_DEVICE_INIT structure.

The SoundExcludeOpen and SoundExcludeClose exclusion codes request and release access to the device, to serialize the device's use. SoundExcludeEnter and SoundExcludeLeave control temporary synchronization to the device. Generally, a driver uses mutex objects to handle these operations.