NdisInitAnsiString macro

The NdisInitAnsiString function initializes a counted ANSI string.

Syntax

void NdisInitAnsiString(
   _as,
   s
);

Parameters

_as

A pointer to a caller-allocated buffer in which this function should store the counted ANSI string.

s

A pointer to a null-terminated string with which to initialize the counted string.

Return Value

None

Remarks

The DestinationString is initialized to point to the SourceString. 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 zero.

Callers of NdisInitAnsiString must 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.

Requirements

   
Minimum supported client Supported for existing drivers in NDIS 6.0 and later, but new drivers should use RtlInitString instead.
Target Platform Universal
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL See Remarks section
DDI compliance rules Irql_Miscellaneous_Function

See Also

DriverEntry of NDIS Protocol Drivers

MiniportInitializeEx

ProtocolBindAdapterEx

RtlAnsiStringToUnicodeString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString