ALLOCATE_SHARED_MEMORY_HANDLER función de devolución de llamada (ndis.h)
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 |
---|---|
|
La operación se ha completado correctamente. |
|
Error en la operación porque no había recursos suficientes para completar la operación. |
|
Error en la operación debido a un parámetro de entrada no válido. |
|
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 |