mirror of https://github.com/tongzx/nt5src
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
418 lines
14 KiB
418 lines
14 KiB
/*++
|
|
|
|
Copyright (c) 1991-1993 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
convdata.c
|
|
|
|
Abstract:
|
|
|
|
RxpConvertDataStructures routine which converts 16- to 32-bit arrays of
|
|
structures and vice versa.
|
|
|
|
Author:
|
|
|
|
Richard Firth (rfirth) 03-Jul-1991
|
|
|
|
Revision History:
|
|
|
|
03-Jul-1991 rfirth
|
|
created
|
|
15-Jul-1991 JohnRo
|
|
Align each structure (e.g. in an array) if necessary. This will,
|
|
for instance, help print dest info level 1 handling. Changed
|
|
RxpConvertDataStructures to allow ERROR_MORE_DATA, e.g. for print APIs.
|
|
Also, use DBG instead of DEBUG equate.
|
|
17-Jul-1991 JohnRo
|
|
Extracted RxpDebug.h from Rxp.h.
|
|
07-Sep-1991 JohnRo
|
|
Made changes suggested by PC-LINT.
|
|
20-Nov-1991 JohnRo
|
|
Clarify which routine an error message is from.
|
|
21-Nov-1991 JohnRo
|
|
Removed NT dependencies to reduce recompiles.
|
|
18-May-1993 JohnRo
|
|
DosPrintQGetInfoW underestimates number of bytes needed.
|
|
Made changes suggested by PC-LINT 5.0
|
|
21-Jun-1993 JohnRo
|
|
RAID 14180: NetServerEnum never returns (alignment bug in
|
|
RxpConvertDataStructures).
|
|
|
|
--*/
|
|
|
|
|
|
|
|
#include <windef.h>
|
|
#include <align.h>
|
|
#include <lmerr.h>
|
|
#include <rxp.h> // My prototype.
|
|
#include <rxpdebug.h> // IF_DEBUG().
|
|
#include <rap.h>
|
|
#include <netdebug.h>
|
|
|
|
|
|
|
|
NET_API_STATUS
|
|
RxpConvertDataStructures(
|
|
IN LPDESC InputDescriptor,
|
|
IN LPDESC OutputDescriptor,
|
|
IN LPDESC InputAuxDescriptor OPTIONAL,
|
|
IN LPDESC OutputAuxDescriptor OPTIONAL,
|
|
IN LPBYTE InputBuffer,
|
|
OUT LPBYTE OutputBuffer,
|
|
IN DWORD OutputBufferSize,
|
|
IN DWORD PrimaryCount,
|
|
OUT LPDWORD EntriesConverted OPTIONAL,
|
|
IN RAP_TRANSMISSION_MODE TransmissionMode,
|
|
IN RAP_CONVERSION_MODE ConversionMode
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
A buffer containing 16- or 32-bit structures is converted to 32- or 16-bit
|
|
structures resp. in a separate buffer. The structures may or may not have
|
|
associated auxiliary structures. The output buffer is expected to be large
|
|
enough to contain all the input data structures plus any variable length
|
|
data items. Therefore, in the worst case, there must be enough space to
|
|
convert all 16-bit items to 32-bits and convert ASCII strings to UNICODE.
|
|
|
|
There may not be any auxiliary structures associated with the primaries,
|
|
in which case the auxiliary descriptor pointers should BOTH BE NULL.
|
|
|
|
Assumptions:
|
|
|
|
IMPORTANT: The input buffer is assumed to have MEANINGFUL pointers.
|
|
|
|
|
|
Arguments:
|
|
|
|
InputDescriptor - Pointer to string describing input primary data structure.
|
|
|
|
OutputDescriptor - Pointer to string describing output primary data
|
|
structure.
|
|
|
|
InputAuxDescriptor - Pointer to string describing input auxiliary data
|
|
structure. May be NULL.
|
|
|
|
OutputAuxDescriptor - Pointer to string describing output auxiliary data
|
|
structure. May be NULL.
|
|
|
|
InputBuffer - Pointer to data area containing input structures.
|
|
|
|
OutputBuffer - Pointer to data area where output structures will be placed.
|
|
If the OutputBufferSize is too small, the contents of the output area
|
|
is undefined.
|
|
|
|
OutputBufferSize - Size of output buffer.
|
|
|
|
PrimaryCount - Number of primary structures in InputBuffer.
|
|
|
|
EntriesConverted - optionally points to a DWORD which will be filled-in
|
|
with the number of entries actually converted. This will be the same
|
|
as PrimaryCount if we return NO_ERROR, but will be less if we return
|
|
ERROR_MORE_DATA.
|
|
|
|
TransmissionMode - Parameter to RapConvertSingleEntry.
|
|
|
|
ConversionMode - Which 16- to 32-bit conversion to use.
|
|
|
|
|
|
Return Value:
|
|
|
|
NET_API_STATUS - NERR_Success or ERROR_MORE_DATA.
|
|
( The callers of this routine assume these are the only two error codes.)
|
|
|
|
--*/
|
|
|
|
{
|
|
NET_API_STATUS status;
|
|
DWORD input_structure_size;
|
|
DWORD output_structure_size;
|
|
DWORD input_aux_structure_size = 0;
|
|
DWORD output_aux_structure_size = 0;
|
|
DWORD input_alignment;
|
|
DWORD output_alignment;
|
|
DWORD input_aux_alignment = 0;
|
|
DWORD output_aux_alignment = 0;
|
|
LPBYTE aligned_input_buffer_start;
|
|
LPBYTE aligned_output_buffer_start;
|
|
BOOL auxiliaries = (InputAuxDescriptor != NULL);
|
|
DWORD aux_count_offset = 0;
|
|
DWORD aux_count = 0;
|
|
DWORD entries_fully_converted = 0;
|
|
LPBYTE next_input_structure;
|
|
LPBYTE next_output_structure;
|
|
|
|
//
|
|
// These next two variables are used by RapConvertSingleEntry which copies
|
|
// stuff to the output buffer and informs us of the amount of space used or
|
|
// required, depending on whether it has enough space to write the data; we
|
|
// assume it will. RapConvertSingleEntry stores the fixed structures at the
|
|
// head of the buffer and starts writing the variable parts (strings) at the
|
|
// bottom. It uses variable_data_pointer as the next writable location for
|
|
// the strings, and updates this variable as it writes to the area pointed to
|
|
//
|
|
|
|
LPBYTE variable_data_pointer;
|
|
DWORD space_occupied = 0;
|
|
|
|
//
|
|
// if the conversion mode is NativeToRap or NativeToNative then the input
|
|
// data is 32-bit. Same for output data
|
|
//
|
|
|
|
BOOL input_is_32_bit = ConversionMode == NativeToRap || ConversionMode == NativeToNative;
|
|
BOOL output_is_32_bit = ConversionMode == RapToNative || ConversionMode == NativeToNative;
|
|
|
|
|
|
#if DBG
|
|
//
|
|
// the auxiliary data descriptors must be both NULL or both non-NULL
|
|
//
|
|
|
|
BOOL aux_in, aux_out;
|
|
|
|
aux_in = (InputAuxDescriptor != NULL);
|
|
aux_out = (OutputAuxDescriptor != NULL);
|
|
|
|
if (aux_in ^ aux_out)
|
|
{
|
|
NetpKdPrint(("RxpConvertDataStructures: "
|
|
"InputAuxDescriptor & OutputAuxDescriptor out of sync\n"));
|
|
NetpAssert(FALSE);
|
|
}
|
|
#endif
|
|
|
|
|
|
input_structure_size = RapStructureSize(InputDescriptor,
|
|
TransmissionMode,
|
|
input_is_32_bit
|
|
);
|
|
output_structure_size = RapStructureSize(OutputDescriptor,
|
|
TransmissionMode,
|
|
output_is_32_bit
|
|
);
|
|
input_alignment = RapStructureAlignment(InputDescriptor,
|
|
TransmissionMode,
|
|
input_is_32_bit
|
|
);
|
|
output_alignment = RapStructureAlignment(OutputDescriptor,
|
|
TransmissionMode,
|
|
output_is_32_bit
|
|
);
|
|
|
|
if (auxiliaries)
|
|
{
|
|
input_aux_structure_size = RapStructureSize(InputAuxDescriptor,
|
|
TransmissionMode,
|
|
input_is_32_bit
|
|
);
|
|
output_aux_structure_size = RapStructureSize(OutputAuxDescriptor,
|
|
TransmissionMode,
|
|
output_is_32_bit
|
|
);
|
|
input_aux_alignment = RapStructureAlignment(InputAuxDescriptor,
|
|
TransmissionMode,
|
|
input_is_32_bit
|
|
);
|
|
output_aux_alignment = RapStructureAlignment(OutputAuxDescriptor,
|
|
TransmissionMode,
|
|
output_is_32_bit
|
|
);
|
|
aux_count_offset = RapAuxDataCountOffset(InputDescriptor,
|
|
TransmissionMode,
|
|
input_is_32_bit
|
|
);
|
|
}
|
|
|
|
//
|
|
// Make sure first (only?) input and output structures are aligned. (This
|
|
// won't do anything for the RAP formats, but is critical for native.)
|
|
//
|
|
aligned_input_buffer_start = RapPossiblyAlignPointer(
|
|
InputBuffer,
|
|
input_alignment,
|
|
input_is_32_bit);
|
|
aligned_output_buffer_start = RapPossiblyAlignPointer(
|
|
OutputBuffer,
|
|
output_alignment,
|
|
output_is_32_bit);
|
|
|
|
//
|
|
// We can't use the space we just skipped over, so update size accordingly.
|
|
//
|
|
|
|
OutputBufferSize -= (DWORD)(aligned_output_buffer_start - OutputBuffer);
|
|
NetpAssert( OutputBufferSize >= 1 );
|
|
|
|
//
|
|
// Initialize roving pointers.
|
|
//
|
|
next_input_structure = aligned_input_buffer_start;
|
|
next_output_structure = aligned_output_buffer_start;
|
|
variable_data_pointer = aligned_output_buffer_start + OutputBufferSize;
|
|
|
|
//
|
|
// For each primary structure, copy the input primary to the output buffer,
|
|
// changing format as we go; copy any associated variable data at the end
|
|
// of the output buffer. Then, if there is an aux count associated with
|
|
// the primary, do the same action for the auxiliary structures and
|
|
// associated strings/variable data
|
|
//
|
|
|
|
while (PrimaryCount--)
|
|
{
|
|
//
|
|
// Convert the data for this instance of the primary structure.
|
|
//
|
|
status = RapConvertSingleEntryEx(
|
|
next_input_structure,
|
|
InputDescriptor, // input desc
|
|
FALSE, // input ptrs NOT meaningless
|
|
aligned_output_buffer_start,
|
|
next_output_structure,
|
|
OutputDescriptor,
|
|
FALSE, // don't set offsets (want ptrs)
|
|
&variable_data_pointer,
|
|
&space_occupied,
|
|
TransmissionMode, // as supplied in parameters
|
|
ConversionMode, // as supplied in parameters
|
|
(ULONG_PTR)InputBuffer
|
|
);
|
|
NetpAssert( status == NERR_Success );
|
|
|
|
if (space_occupied > OutputBufferSize)
|
|
{
|
|
IF_DEBUG(CONVDATA) {
|
|
NetpKdPrint(("RxpConvertDataStructures: "
|
|
"output buffer size blown by primary\n"));
|
|
}
|
|
status = ERROR_MORE_DATA;
|
|
goto Cleanup;
|
|
}
|
|
|
|
//
|
|
// if we have auxiliary structs, pull out the number associated
|
|
// with this primary struct from the primary struct itself
|
|
// before pointing to the next copy location (this allows us to
|
|
// handle the case where there are a variable number of aux
|
|
// structs per each primary. There may not be such a case, but
|
|
// this is defensive programming)
|
|
//
|
|
|
|
if (auxiliaries)
|
|
{
|
|
if (input_is_32_bit)
|
|
{
|
|
aux_count = *(LPDWORD)(next_input_structure + aux_count_offset);
|
|
}
|
|
else
|
|
{
|
|
aux_count = *(LPWORD)(next_input_structure + aux_count_offset);
|
|
}
|
|
}
|
|
|
|
//
|
|
// Bump to next element of each array (or just beyond end, if we're
|
|
// done).
|
|
//
|
|
next_input_structure += input_structure_size;
|
|
next_output_structure += output_structure_size;
|
|
|
|
//
|
|
// Make sure each primary structure is aligned. (This won't do anything
|
|
// for the RAP formats, but is critical for native.)
|
|
//
|
|
next_input_structure = RapPossiblyAlignPointer(
|
|
next_input_structure, input_alignment, input_is_32_bit);
|
|
|
|
{
|
|
DWORD NextOutputAlignment =
|
|
(DWORD)((LPBYTE) (RapPossiblyAlignPointer(
|
|
next_output_structure,
|
|
output_alignment,
|
|
output_is_32_bit))
|
|
- next_output_structure);
|
|
|
|
NetpAssert( NextOutputAlignment < ALIGN_WORST );
|
|
if (NextOutputAlignment > 0) {
|
|
next_output_structure += NextOutputAlignment;
|
|
space_occupied += NextOutputAlignment;
|
|
}
|
|
}
|
|
|
|
//
|
|
// use aux_count to determine whether loop should be performed
|
|
//
|
|
|
|
while (aux_count)
|
|
{
|
|
//
|
|
// Convert the data for this instance of the secondary structure.
|
|
//
|
|
status = RapConvertSingleEntryEx(
|
|
next_input_structure,
|
|
InputAuxDescriptor,
|
|
FALSE, // input ptrs NOT meaningless
|
|
aligned_output_buffer_start,
|
|
next_output_structure,
|
|
OutputAuxDescriptor,
|
|
FALSE, // don't set offsets (want ptrs)
|
|
&variable_data_pointer,
|
|
&space_occupied,
|
|
TransmissionMode, // as supplied in parameters
|
|
ConversionMode, // as supplied in parameters
|
|
(ULONG_PTR)InputBuffer
|
|
);
|
|
NetpAssert( status == NERR_Success );
|
|
|
|
if (space_occupied > OutputBufferSize)
|
|
{
|
|
IF_DEBUG(CONVDATA) {
|
|
NetpKdPrint(("RxpConvertDataStructures: "
|
|
"output buffer size blown by secondary\n"));
|
|
}
|
|
status = ERROR_MORE_DATA;
|
|
goto Cleanup;
|
|
}
|
|
|
|
next_input_structure += input_aux_structure_size;
|
|
next_output_structure += output_aux_structure_size;
|
|
--aux_count;
|
|
|
|
//
|
|
// Make sure next structure (if any) is aligned. (This won't do
|
|
// anything for the RAP formats, but is critical for native.)
|
|
//
|
|
next_input_structure = RapPossiblyAlignPointer(
|
|
next_input_structure,
|
|
input_aux_alignment,
|
|
input_is_32_bit);
|
|
next_output_structure = RapPossiblyAlignPointer(
|
|
next_output_structure,
|
|
output_aux_alignment,
|
|
output_is_32_bit);
|
|
space_occupied = RapPossiblyAlignCount(
|
|
space_occupied,
|
|
output_aux_alignment,
|
|
output_is_32_bit);
|
|
|
|
} // while (aux_count)
|
|
|
|
++entries_fully_converted;
|
|
|
|
} // while (primary_count--)
|
|
|
|
status = NERR_Success;
|
|
|
|
Cleanup:
|
|
|
|
if (EntriesConverted != NULL) {
|
|
*EntriesConverted = entries_fully_converted;
|
|
}
|
|
|
|
return (status);
|
|
}
|