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

  • Статья

Функция 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 (включая Ndis.h)
IRQL PASSIVE_LEVEL

См. также раздел

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory