NdisFreeString 매크로(ndis.h)

아티클
02/26/2024

NdisFreeString 함수는 버퍼링된 문자열에 대해 NdisInitializeString에 의해 할당된 스토리지를 해제합니다.

구문

void NdisFreeString(
  [in]  String
);

매개 변수

[in] String

해제할 문자열을 설명하는 NDIS_STRING 형식 값입니다. Windows 2000 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

반환 값

없음

설명

NDIS 드라이버는 일반적으로 초기화 중에 NdisInitializeString 함수를 호출하여 NdisXxx구성 함수에 전달된 이름을 설정합니다. 드라이버가 NdisInitializeString을 호출할 때마다 드라이버는 NdisFreeString에 해당하는 호출을 수행해야 합니다. 초기화 중에 할당된 문자열 버퍼를 해제할 때 드라이버의 초기화 함수가 컨트롤을 반환하기 전에 드라이버가 NdisFreeString 을 호출해야 합니다.

NdisFreeString 은 NdisInitializeString으로 할당된 버퍼를 해제하는 데만 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 기존 드라이버에 대해 지원되지만 새 드라이버는 RtlFreeAnsiString 또는 RtlFreeUnicodeString을 대신 사용해야 합니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	Irql_Miscellaneous_Function(ndis)