Macro NdisFreeString (ndis.h)

Artigo
02/27/2024

A função NdisFreeString libera o armazenamento que foi alocado por NdisInitializeString para uma cadeia de caracteres em buffer.

Sintaxe

void NdisFreeString(
  [in]  String
);

Parâmetros

[in] String

Um valor de tipo NDIS_STRING que descreve a cadeia de caracteres a ser livre. Para o Windows 2000 e posterior, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .

Retornar valor

Nenhum

Comentários

Um driver NDIS normalmente chama a função NdisInitializeString durante a inicialização , por exemplo, para configurar nomes passados para as funções de Configuração NdisXxx. Para cada chamada que o driver faz para NdisInitializeString, o driver deve fazer uma chamada correspondente para NdisFreeString. Ao liberar buffers de cadeia de caracteres alocados durante a inicialização, um driver deve chamar NdisFreeString antes que a função de inicialização do driver retorne o controle.

NdisFreeString deve ser usado apenas para liberar buffers alocados com NdisInitializeString.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers existentes no NDIS 6.0 e posterior, mas novos drivers devem usar RtlFreeAnsiString ou RtlFreeUnicodeString.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	Irql_Miscellaneous_Function(ndis)