SoundReportResourceUsage

NTSTATUS
    SoundReportResourceUsage(
        IN PDEVICE_OBJECT DeviceObject,
        IN INTERFACE_TYPE BusType,
        IN ULONG BusNumber,
        IN PULONG InterruptNumber OPTIONAL,
        IN KINTERRUPT_MODE InterruptMode,
        IN BOOLEAN InterruptShareDisposition,
        IN PULONG DmaChannel OPTIONAL,
        IN PULONG FirstIoPort OPTIONAL,
        IN ULONG IoPortLength
        );

The SoundReportResourceUsage function reserves hardware resources for use by the specified device or driver. This function does not allow reservation of resources already reserved for another device or driver.

Parameters

DeviceObject

Pointer to either a DEVICE_OBJECT or DRIVER_OBJECT structure. Represents the device or driver for which resources will be reserved.

BusType

Type of bus the device is on. INTERFACE_TYPE is defined in ntddk.h.

BusNumber

Number of the bus the device is on.

InterruptNumber

Pointer to the interrupt number, or NULL if no interrupt.

InterruptMode

Interrupt mode (Latched or LevelSensitive). Ignored if InterruptNumber is NULL. KINTERRUPT_MODE is defined in ntddk.h.

InterruptShareDisposition

TRUE if interrupt can be shared, FALSE otherwise. Ignored if InterruptNumber is NULL.

DmaChannel

Pointer to the device’s DMA channel, or NULL if there is no DMA channel.

FirstIoPort

Pointer to the device’s first I/O port address, or NULL if there are no I/O ports.

IoPortLength

Number of bytes of I/O space the device uses, starting at FirstIoPort. Ignored if FirstIoPort is NULL.

Return Value

Returns one of the following values.

Value	Definition
STATUS_SUCCESS	Success.
STATUS_DEVICE_CONFIGURATION_ERROR	Resources already assigned.
STATUS_INSUFFICIENT_RESOURCES	Resources unavailable.

Comments

Before attempting to access device hardware, call SoundReportResourceUsage to ensure the resources you intend to use are not already assigned to another device.

You can associate resources with either the driver object or with one of the device objects created by SoundCreateDevice. If the driver supports multiple cards, you must associate resources with device objects.

Each time you call SoundReportResourceUsage for a particular device object or driver object, you override the resource reservation made with any previous call for the same object.

Typically, a driver acquires resources for each device in turn, and then calls SoundReportResourceUsage a final time to declare (to the rest of the system) all the resources used by the card instance.

To free reserved resources, call SoundFreeDevice.