NdisInitAnsiString

This function initializes a counted ASCII string.

At a Glance

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

Syntax

VOID NdisInitAnsiString( IN OUT PNDIS_ANSI_STRING DestinationString, IN PCSTR SourceString );

Parameters

DestinationString: Pointer to a caller-allocated buffer in which this function should store the counted ASCII 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 parameter. The length and maximum length for the 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.