NdisAllocateBuffer
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função cria um mapeamento descritor reserva um intervalo virtual especificado ou subintervalo em um bloco memória já alocada.
Syntax
VOID NdisAllocateBuffer(
PNDIS_STATUS Status,
PNDIS_BUFFER* Buffer,
NDIS_HANDLE PoolHandle,
PVOID VirtualAddress,
UINT Length
);
Parameters
- Status
[out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o status final da alocação de reserva.
- Buffer
[out] Ponteiro para uma variável Caller-supplied no qual essa função retorna um ponteiro para o descritor alocado reserva.
- PoolHandle
[no] Identificador retornado por uma acima chamar para o NdisAllocateBufferPool função.
- VirtualAddress
[no] Ponteiro para o endereço virtual de base do sistema anteriormente alocado-memória espaço a ser mapeada no descritor de reserva retornado.
- Comprimento
[no] Especifica o número de bytes a ser mapeada.
Return Value
NDIS_STATUS_SUCCESS indica sucesso. NDIS_STATUS_FAILURE indica falha.
Remarks
Essa função aloca armazenamento para e inicializa um descritor reserva para um intervalo especificado de memória alocada anteriormente, such as memória usada para um cabeçalho pacote ou um buffer de recepção NIC mapa (n.); mapear (v.).
Alocação descritor de buffer desenha no pool de reserva que NdisAllocateBufferPool Cria. Um driver pode chamar esta função como many times conforme necessário para alocar descritores de reserva que ele requer se ele chamado NdisAllocateBufferPool durante inicialização.
O driver deve versão qualquer rotação bloqueio que ele está atualmente mantendo antes chamado essa função.
Todos os inferior-nível drivers NDIS devem alocar todos os descritores reserva que eles encadear para pacotes de um pool reserva. Somente os drivers mais alto nível de protocolo podem ser designados OS-dependente descritores mapeamento intervalos memória virtual, e, se esses descritores memória são equivalente para NDIS reserva descritores, um protocolo de nível mais alto possível transmitir esses descritores como parâmetros para funções NDIS.
Requirements
| Header | ndis.h |
| Library | ndis.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |