ALLOCATE_SHARED_MEMORY_HANDLER função de retorno de chamada (ndis.h)

Artigo
02/07/2025

A função NetAllocateSharedMemory (ponto de entrada ALLOCATE_SHARED_MEMORY_HANDLER) é chamada pelo NDIS quando um driver aloca memória compartilhada de um provedor de memória compartilhada.

Sintaxe

ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;

NDIS_STATUS AllocateSharedMemoryHandler(
  [in]      NDIS_HANDLE ProviderContext,
  [in]      PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
  [in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}

Parâmetros

[in] ProviderContext

Uma NDIS_HANDLE a um bloco de informações de contexto alocadas pelo driver que identifica o provedor. O provedor forneceu essas informações no providerContext membro do NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS estrutura.

[in] SharedMemoryParameters

Um ponteiro para um NDIS_SHARED_MEMORY_PARAMETERS estrutura que define os atributos solicitados para a memória compartilhada.

[in, out] pSharedMemoryProviderContext

Um ponteiro para um identificador para uma área de contexto de memória compartilhada. O provedor de memória compartilhada fornece um identificador que identifica a memória compartilhada que ele alocou.

Valor de retorno

NetAllocateSharedMemory pode retornar os seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com êxito.
NDIS_STATUS_RESOURCES	A operação falhou porque não havia recursos suficientes para concluir a operação.
NDIS_STATUS_INVALID_PARAMETER	A operação falhou devido a um parâmetro de entrada inválido.
NDIS_STATUS_FAILURE	A operação falhou por motivos não especificados.

Observações

O NDIS chama a função NetAllocateSharedMemory de um provedor de memória compartilhado quando um driver chama o função de NdisAllocateSharedMemory.

O provedor de memória compartilhada especificou o ponto de entrada (ALLOCATE_SHARED_MEMORY_HANDLER) para NetAllocateSharedMemory no NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS estrutura.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.20 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	PASSIVE_LEVEL

Consulte também

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory

Partilhar via