Função NdisInitializeString (ndis.h)

Artigo
02/26/2024

A função NdisInitializeString aloca armazenamento para e inicializa uma cadeia de caracteres contada no conjunto de caracteres padrão do sistema.

Sintaxe

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Parâmetros

Destination

Um ponteiro para um NDIS_STRING com um buffer NULL . No retorno dessa função, o NDIS_STRING contém uma cadeia de caracteres inicializada e contada. Para o Windows 2000 e posterior, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .

Source

Um ponteiro para uma cadeia de caracteres terminada em nulo com a qual inicializar a cadeia de caracteres contada. SourceString não deve ser NULL.

Retornar valor

Nenhum

Comentários

NdisInitializeString define os membrosLength e MaximumLength de NDIS_STRING para a cadeia de caracteres de destino e encerra a cadeia de caracteres de destino com zero. Para drivers windows 2000 e posteriores, NdisInitializeString converte a cadeia de caracteres de origem fornecida em caracteres Unicode.

SourceString não deve ser NULL.

O buffer alocado por NdisInitializeString deve ser liberado com a função NdisFreeString .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers existentes no NDIS 6.0 e posterior, mas novos drivers devem usar RtlInitUnicodeString ou RTL_CONSTANT_STRING ou DECLARE_CONST_UNICODE_STRING (consulte ntdef.h).
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	Irql_Miscellaneous_Function(ndis)