NdisInitializeString 함수(ndis.h)

NdisInitializeString 함수는 시스템 기본 문자 집합에서 계산된 문자열에 대한 스토리지를 할당하고 초기화합니다.

구문

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

매개 변수

Destination

NULL 버퍼가 있는 NDIS_STRING 대한 포인터입니다. 이 함수에서 반환될 때 NDIS_STRING 초기화된 계산된 문자열을 포함합니다. Windows 2000 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

Source

계산된 문자열을 초기화할 null로 끝나는 문자열에 대한 포인터입니다. SourceString은 NULL 이 아니어야 합니다.

반환 값

없음

설명

NdisInitializeString 은 대상 문자열에 대한 NDIS_STRING LengthMaximumLength 멤버를 설정하고 대상 문자열을 0으로 종료합니다. Windows 2000 이상 드라이버의 경우 NdisInitializeString 은 제공된 소스 문자열을 유니코드 문자로 변환합니다.

SourceString은 NULL 이 아니어야 합니다.

NdisInitializeString 에서 할당한 버퍼는 NdisFreeString 함수를 사용하여 해제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 NDIS 6.0 이상에서 기존 드라이버에 대해 지원되지만 새 드라이버는 RtlInitUnicodeString 또는 RTL_CONSTANT_STRING 또는 DECLARE_CONST_UNICODE_STRING(ntdef.h 참조)를 대신 사용해야 합니다.
대상 플랫폼 유니버설
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 Irql_Miscellaneous_Function(ndis)

참고 항목

ANSI_STRING

NDIS 프로토콜 드라이버의 DriverEntry

MiniportInitializeEx

RtlAnsiStringToUnicodeString

RtlEqualUnicodeString

RtlFreeAnsiString

RtlFreeUnicodeString

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING