NdisInitializeString

This function allocates storage for and initializes a counted string in the system-default character set.

At a Glance

Syntax

VOID NdisInitializeString( IN OUT PNDIS_STRING DestinationString,
IN PUCHAR SourceString );

Parameters

DestinationString

Specifies NULL when this function is called; on return from this function, points to a buffer containing an initialized counted string.

SourceString

Pointer to a 0-terminated string with which to initialize the counted string.

Remarks

This function sets the Length and MaximumLength for the destination string and terminates the destination string with 0.

If SourceString is NULL, the lengths are set to 0.

The buffer allocated by this function should be released promptly with the NdisFreeString function.

A driver that calls this function runs at IRQL PASSIVE_LEVEL.

See Also

NdisAnsiStringToUnicodeString, NdisEqualString, NdisFreeString, NdisInitAnsiString, NdisInitUnicodeString, NdisUnicodeStringToAnsiString