Compartilhar via


Macro NdisFreeString (ndis.h)

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 de NDIS_STRING como um tipo de UNICODE_STRING.

Valor de retorno

Nenhum

Observações

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 deNdis Xxx. 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 que foram 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 que foram alocados com NdisInitializeString.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte para drivers existentes no NDIS 6.0 e posterior, mas novos drivers devem usar RtlFreeAnsiString ou RtlFreeUnicodeString.
da 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)

Consulte também

ANSI_STRING

DriverEntry de drivers de protocolo NDIS

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

rtlInitString

rtlInitUnicodeString

rtlUnicodeStringToAnsiString

UNICODE_STRING