Compartilhar via


Função NdisInitializeString (ndis.h)

A função NdisInitializeString aloca o armazenamento 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 de NULL. Ao retornar 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 de 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.

Valor de retorno

Nenhum

Observações

NdisInitializeString define os membros de Comprimento e MaximumLength de NDIS_STRING para a cadeia de caracteres de destino e termina 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
de cliente com suporte mínimo 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) em vez disso.
da Plataforma de Destino Universal
cabeçalho ndis.h (inclua Ndis.h)
biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
regras de conformidade de DDI Irql_Miscellaneous_Function(ndis)

Consulte também

ANSI_STRING

DriverEntry de drivers de protocolo NDIS

MiniportInitializeEx

RtlAnsiStringToUnicodeString

RtlEqualUnicodeString

rtlFreeAnsiString

rtlFreeUnicodeString

rtlInitString

rtlInitUnicodeString

rtlUnicodeStringToAnsiString

UNICODE_STRING