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 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) |