функция обратного вызова ALLOCATE_SHARED_MEMORY_HANDLER (ndis.h)

Статья
02/07/2025

Функция NetAllocateSharedMemory (точка входа ALLOCATE_SHARED_MEMORY_HANDLER) вызывается NDIS, когда драйвер выделяет общую память от поставщика общей памяти.

Синтаксис

ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;

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

Параметры

[in] ProviderContext

NDIS_HANDLE к блоку информации о контексте, выделенной драйвером, которая определяет поставщика. Поставщик предоставил эти сведения в элементе ProviderContextструктура NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS.

[in] SharedMemoryParameters

Указатель на объект NDIS_SHARED_MEMORY_PARAMETERS структура, которая определяет запрошенные атрибуты для общей памяти.

[in, out] pSharedMemoryProviderContext

Указатель на дескриптор для области контекста общей памяти. Поставщик общей памяти предоставляет дескриптор, определяющий выделенную им общую память.

Возвращаемое значение

NetAllocateSharedMemory может возвращать следующие значения состояния:

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	Операция успешно завершена.
NDIS_STATUS_RESOURCES	Операция завершилась сбоем, так как для завершения операции недостаточно ресурсов.
NDIS_STATUS_INVALID_PARAMETER	Операция завершилась ошибкой из-за недопустимого входного параметра.
NDIS_STATUS_FAILURE	Операция завершилась ошибкой из-за неуказаемых причин.

Замечания

NDIS вызывает функцию NetAllocateSharedMemory поставщика общей памяти при вызове драйвера функции NdisAllocateSharedMemory.

Поставщик общей памяти указал точку входа (ALLOCATE_SHARED_MEMORY_HANDLER) для NetAllocateSharedMemory в структура NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.20 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

См. также

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory

Поделиться через