NdisInitAnsiString (NDIS 5.1) function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisInitAnsiString initializes a counted ANSI string.

Syntax


VOID NdisInitAnsiString(
  _Inout_ PANSI_STRING DestinationString,
  _In_    PCSTR        SourceString
);

Parameters

DestinationString [in, out]

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

SourceString [in]

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

Target platform

Universal

Version

See NdisInitAnsiString.

Header

Ndis.h (include Ndis.h)

IRQL

See Remarks section.

See also

DriverEntry of NDIS Protocol Drivers
MiniportInitialize
NdisAnsiStringToUnicodeString
NdisInitializeString
NdisInitUnicodeString
NdisUnicodeStringToAnsiString
ProtocolBindAdapter

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft