NdisInitUnicodeString (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.

NdisInitUnicodeString initializes a counted Unicode string.

Syntax


VOID NdisInitUnicodeString(
  _Inout_ PNDIS_STRING DestinationString,
  _In_    PCWSTR       SourceString
);

Parameters

DestinationString [in, out]

Pointer to a caller-allocated NDIS_STRING type in which NdisInitUnicodeString should store the counted Unicode string. For Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

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 MaximumLength members of NDIS_STRING for the DestinationString are initialized to the length of the string at SourceString. If SourceString is NULL, the length is zero.

Callers of NdisInitUnicodeString 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 NdisInitUnicodeString.

Header

Ndis.h (include Ndis.h)

IRQL

See Remarks section.

See also

DriverEntry of NDIS Protocol Drivers
MiniportInitialize
NdisAnsiStringToUnicodeString
NdisInitAnsiString
NdisInitializeString
NdisUnicodeStringToAnsiString
ProtocolBindAdapter
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft