ALLOCATE_SHARED_MEMORY_HANDLER funzione di callback (ndis.h)

Articolo
02/29/2024

La funzione NetAllocateSharedMemory (ALLOCATE_SHARED_MEMORY_HANDLER punto di ingresso) viene chiamata da NDIS quando un driver alloca memoria condivisa da un provider di memoria condivisa.

Sintassi

ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;

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

Parametri

[in] ProviderContext

Un NDIS_HANDLE a un blocco di informazioni sul contesto allocato dal driver che identifica il provider. Il provider ha fornito queste informazioni nel membro ProviderContext del NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS struttura.

[in] SharedMemoryParameters

Puntatore a un oggetto NDIS_SHARED_MEMORY_PARAMETERS struttura che definisce gli attributi richiesti per la memoria condivisa.

[in, out] pSharedMemoryProviderContext

Puntatore a un handle per un'area di contesto di memoria condivisa. Il provider di memoria condivisa fornisce un handle che identifica la memoria condivisa allocata.

Valore restituito

NetAllocateSharedMemory può restituire i valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione riuscita.
NDIS_STATUS_RESOURCES	L'operazione non è riuscita perché sono presenti risorse insufficienti per completare l'operazione.
NDIS_STATUS_INVALID_PARAMETER	L'operazione non è riuscita a causa di un parametro di input non valido.
NDIS_STATUS_FAILURE	L'operazione non è riuscita per motivi non specificati.

Commenti

NDIS chiama la funzione NetAllocateSharedMemory di un provider di memoria condivisa quando un driver chiama Funzione NdisAllocateSharedMemory .

Il provider di memoria condivisa ha specificato il punto di ingresso (ALLOCATE_SHARED_MEMORY_HANDLER) per NetAllocateSharedMemory in NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS struttura.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.20 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Vedi anche

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory

Condividi tramite