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 関数。

共有メモリ プロバイダーは、 で NetAllocateSharedMemory のエントリ ポイント (ALLOCATE_SHARED_MEMORY_HANDLER) を指定しました NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS 構造体。

要件

要件 値
サポートされている最小のクライアント NDIS 6.20 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory