ALLOCATE_SHARED_MEMORY_HANDLER función de devolución de llamada (ndis.h)

  • Artículo

NDIS llama a la función NetAllocateSharedMemory (punto de entrada ALLOCATE_SHARED_MEMORY_HANDLER) cuando un controlador asigna memoria compartida desde un proveedor de memoria compartida.

Sintaxis

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

Una NDIS_HANDLE a un bloque de información de contexto asignada por el controlador que identifica al proveedor. El proveedor proporcionó esta información en el miembro ProviderContext del NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS estructura.

[in] SharedMemoryParameters

Puntero a un NDIS_SHARED_MEMORY_PARAMETERS estructura que define los atributos solicitados para la memoria compartida.

[in, out] pSharedMemoryProviderContext

Puntero a un identificador para un área de contexto de memoria compartida. El proveedor de memoria compartida proporciona un identificador que identifica la memoria compartida que asignó.

Valor devuelto

NetAllocateSharedMemory puede devolver los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 La operación se ha completado correctamente.
NDIS_STATUS_RESOURCES
 Error en la operación porque no había recursos suficientes para completar la operación.
NDIS_STATUS_INVALID_PARAMETER
 Error en la operación debido a un parámetro de entrada no válido.
NDIS_STATUS_FAILURE
 Error en la operación por motivos no especificados.

Comentarios

NDIS llama a la función NetAllocateSharedMemory de un proveedor de memoria compartida cuando un controlador llama al Función NdisAllocateSharedMemory .

El proveedor de memoria compartida especificó el punto de entrada (ALLOCATE_SHARED_MEMORY_HANDLER) para NetAllocateSharedMemory en el NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS estructura.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.20 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
IRQL PASSIVE_LEVEL

Consulte también

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory