iokit/IOKit/IOMultiMemoryDescriptor.h

34 /*! @class IOMultiMemoryDescriptor : public IOMemoryDescriptor
35     @abstract The IOMultiMemoryDescriptor object describes a memory area made up of several other IOMemoryDescriptors.
36     @discussion The IOMultiMemoryDescriptor object represents multiple ranges of memory, specified as an ordered list of IOMemoryDescriptors.  The descriptors are chained end-to-end to make up a single contiguous buffer. */
38 class IOMultiMemoryDescriptor : public IOMemoryDescriptor
40     OSDeclareDefaultStructors(IOMultiMemoryDescriptor);
53     @abstract Create an IOMultiMemoryDescriptor to describe a memory area made up of several other IOMemoryDescriptors.
54     @discussion This method creates and initializes an IOMultiMemoryDescriptor for memory consisting of a number of other IOMemoryDescriptors, chained end-to-end (in the order they appear in the array) to represent a single contiguous memory buffer.  Passing the descriptor array as a reference will avoid an extra allocation.
58     @param asReference If false, the IOMultiMemoryDescriptor object will make a copy of the descriptors array, otherwise, the array will be used in situ, avoiding an extra allocation.
59     @result The created IOMultiMemoryDescriptor on success, to be released by the caller, or zero on failure. */
61     static IOMultiMemoryDescriptor * withDescriptors(
68     @abstract Initialize an IOMultiMemoryDescriptor to describe a memory area made up of several other IOMemoryDescriptors.
69     @discussion This method initializes an IOMultiMemoryDescriptor for memory consisting of a number of other IOMemoryDescriptors, chained end-to-end (in the order they appear in the array) to represent a single contiguous memory buffer.  Passing the descriptor array as a reference will avoid an extra allocation.
73     @param asReference If false, the IOMultiMemoryDescriptor object will make a copy of the descriptors array, otherwise, the array will be used in situ, avoiding an extra allocation.
74     @result The created IOMultiMemoryDescriptor on success, to be released by the caller, or zero on failure. */