Compartilhar via

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

  • Artigo

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 compartilhado.

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

Um NDIS_HANDLE a um bloco de informações de contexto alocadas pelo driver que identifica o provedor. O provedor forneceu essas informações no membro ProviderContext 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 alocada.

Retornar valor

NetAllocateSharedMemory pode retornar os seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
 A operação foi concluída com sucesso.
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.

Comentários

O NDIS chama a função NetAllocateSharedMemory de um provedor de memória compartilhado quando um driver chama o Função 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
Cliente mínimo com suporte Com suporte no NDIS 6.20 e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
IRQL PASSIVE_LEVEL

Confira também

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory