Função NdisAllocateCloneNetBufferList (ndis/nblapi.h)

Artigo
02/26/2024

Chame a função NdisAllocateCloneNetBufferList para criar um novo clone NET_BUFFER_LIST estrutura.

Sintaxe

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateCloneNetBufferList(
  [in]           NET_BUFFER_LIST *OriginalNetBufferList,
  [in, optional] NDIS_HANDLE     NetBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     NetBufferPoolHandle,
  [in]           ULONG           AllocateCloneFlags
);

Parâmetros

[in] OriginalNetBufferList

Um ponteiro para uma estrutura de NET_BUFFER_LIST existente.

[in, optional] NetBufferListPoolHandle

Um identificador que foi obtido de uma chamada para o Função NdisAllocateNetBufferListPool .

[in, optional] NetBufferPoolHandle

Um identificador de pool de estrutura NET_BUFFER que foi retornado anteriormente de uma chamada para NdisAllocateNetBufferPool.

[in] AllocateCloneFlags

Sinalizadores NDIS que podem ser combinados com uma operação OR. Os seguintes sinalizadores são definidos:

NDIS_CLONE_FLAGS_RESERVED

Reservado para NDIS.

NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS

Se esse sinalizador for definido, o NDIS não alocará novos MDLs para o NET_BUFFER_LIST clonado. Em vez disso, o NET_BUFFER_LIST clonado usa a mesma cadeia de MDL que o NET_BUFFER_LIST original. Se NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS estiver limpo, o NDIS alocará novos MDLs para referenciar os buffers de dados originais.

Retornar valor

NdisAllocateCloneNetBufferList retorna um ponteiro para o novo clone NET_BUFFER_LIST estrutura. Se a alocação não tiver sido bem-sucedida, esse ponteiro será NULL.

Comentários

Chame NdisAllocateCloneNetBufferList para criar um clone NET_BUFFER_LIST estrutura que você pode usar para enviar dados duplicados em um caminho de dados separado.

Cada estrutura NET_BUFFER na estrutura de NET_BUFFER_LIST original só é clonada desde o início do espaço de dados usado, não o início de todo o espaço de dados. Para obter o deslocamento do início do espaço de dados até o início do espaço de dados usado, use a macro NET_BUFFER_DATA_OFFSET .

Se a estrutura de NET_BUFFER_LIST clonada deve ter atributos associados a um determinado pool, o chamador deve especificar o identificador de pool no parâmetro NetBufferListPoolHandle ou NetBufferPoolHandle . Por exemplo, o membro ProtocolType da estrutura NET_BUFFER_LIST está associado ao pool.

A estrutura de NET_BUFFER_LIST de clone descreve os mesmos dados descritos pela estrutura NET_BUFFER_LIST em OriginalNetBufferList. O NDIS não copia os dados descritos pelos MDLs originais para novos buffers de dados. Em vez disso, as estruturas clonadas fazem referência aos buffers de dados originais. A estrutura de NET_BUFFER_LIST de clones não inclui uma inicial NET_BUFFER_LIST_CONTEXT estrutura.

Chamar o A função NdisFreeCloneNetBufferList libera uma estrutura NET_BUFFER_LIST e todas as estruturas associadas e cadeias de MDL alocadas chamando NdisAllocateCloneNetBufferList.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Universal
Cabeçalho	ndis/nblapi.h (inclua ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_NetBuffer_Function(ndis), NdisAllocateCloneNetBufferList(ndis), NdisAllocateCloneNetBufferList_InitFail(ndis)