ALLOCATE_SHARED_MEMORY_HANDLER funzione di callback (ndis.h)
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 allocate dal driver che identificano il provider. Il provider ha fornito queste informazioni nel ProviderContext membro 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 del 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 |
|---|---|
|
Operazione completata correttamente. |
|
L'operazione non è riuscita perché non sono state eseguite risorse sufficienti per completare l'operazione. |
|
L'operazione non è riuscita a causa di un parametro di input non valido. |
|
L'operazione non è riuscita per motivi non specificati. |
Osservazioni
NDIS chiama il NetAllocateSharedMemory funzione di un provider di memoria condivisa quando un driver chiama funzione di 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.
Fabbisogno
| 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 |