Creative AWE32 - Page 52

To Next Page

To Previous Page

SB AWE32 Developer's Information Pack PART III Windows Driver API •• 51

Member Remarks

m_Size Indicates the size of buffer available.

m_Buffer Far pointer to a buffer area.

Upon returning, the manager will update the following fields:

Member Remarks

m_SizeUsed Number of characters from buffer used.

m_Flag The synthesizer emulation index.

m_Buffer String of current bank descriptor.

The buffer area will be filled by the manager with the descriptor of the

current Synthesizer Bank. The

m_Flag

will contain the Synth Bank Index to

the available emulation.

lParam2

Unused.

hUserID

Current ID assigned to the application by the AWE Manager during

initialization.

Remarks

The following are some important points to note when using this function.

The location passed in as pointer must be valid memory locations allocated

by the parent application. If the locations are invalid, it is possible to trip

General Protection Fault in Windows.

If the buffer is not sufficient to complete the operation, AWE Manager will

not update string entries into the buffer. However, other return parameters

will still be updated.

Return

The return value would be AWE_NO_ERR if the operation is successful, and

an error code otherwise. Possible errors are:

AWE_ERR_USERID_INVALID

AWE_ERR_RESOURCE_INSUFFICIENT