[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    AllocAslRequest -- alloc an ASL requester, with tagitem modifiers (v36)

SYNOPSIS
    request = AllocAslRequest( type, ptags )
    D0                         D0    A0

    APTR    request;
    ulong   type;
    struct tagitem       *ptags;

FUNCTION
    Allocates an ASL requester data structure of the specified type,
    with optional tagitem modifiers.

INPUTS
    type = type of requester to create.  Currently defined types
        include ASL_FileRequest and ASL_FontRequest.
    ptags = pointer to a tagitem array, which is defined for each
        specified type.  See "asl.h" and example programs for usage
        of various tag types.  See aslrequest() for specifications
        of currently defined tag values and their effects.

    Note that tag values stay in effect for each use of the
    requester until they are cleared or modified by passing the
    same tag with a new value.

    AllocAslRequestTags( type, tags... ) which accepts your tags
    on the stack, is available in amiga.lib.

    Example Usage: AllocAslRequestTags( ASL_FileRequest,
                                        ASL_Hail, "My Title Bar",
                                        TAG_DONE );

RESULT
    Pointer to an initialized requester data structure, or NULL on
    failure.  The data structure returned will match the requested
    type; for type ASL_FileRequest, a struct filerequester *; for
    ASL_FontRequest, a struct fontrequester *.

    The requester returned may then be passed to aslrequest(), and
    is freed by calling freeaslrequest().

SEE ALSO
    aslrequest(), freeaslrequest()