NdisInitUnicodeString

This function initializes a counted Unicode string.

At a Glance

Header file: Ndis.h
Windows CE versions: 2.0 and later

Syntax

VOID NdisInitUnicodeString( IN OUT PNDIS_STRING DestinationString,
IN PCWSTR SourceString );

Parameters

DestinationString
Pointer to a caller-allocated buffer in which this function stores the counted Unicode string.
SourceString
Pointer to a 0-terminated string with which to initialize the counted string.

Remarks

The DestinationString parameter is initialized to point to the SourceString. The length and maximum length for DestinationString are initialized to the length of the string at SourceString. If SourceString is NULL, the length is 0.

A driver that calls this function can be running at IRQL <= DISPATCH_LEVEL if the DestinationString buffer is allocated from nonpaged memory. Usually, callers are running at IRQL PASSIVE_LEVEL during driver initialization.

See Also

NdisAnsiStringToUnicodeString, NdisFreeString, NdisInitAnsiString, NdisInitializeString, NdisUnicodeStringToAnsiString