Função NdisInitializeString (ndis.h)
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) |