Função NdisAllocateGenericObject (ndis.h)
Os componentes que não têm um identificador NDIS usam a função NdisAllocateGenericObject para alocar um objeto NDIS genérico.
Sintaxe
PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
[optional] PDRIVER_OBJECT DriverObject,
ULONG Tag,
USHORT Size
);
Parâmetros
[optional] DriverObject
Um objeto de driver a ser associado ao objeto genérico. Este parâmetro pode ser NULL.
Tag
A marca de memória do kernel que o NDIS deve usar para alocar memória para o objeto genérico.
Size
A quantidade de memória, em bytes, a ser reservada para o chamador. Isso não inclui o tamanho da estrutura NDIS_GENERIC_OBJECT . Use o espaço de memória adicional para suas próprias finalidades. Para acessar a memória adicional, use sizeof(NDIS_GENERIC_OBJECT) para ignorar a estrutura de objeto genérico.
Retornar valor
NdisAllocateGenericObject retorna um ponteiro para o NDIS_GENERIC_OBJECT alocado. Se o NDIS não tiver criado o objeto, o valor retornado será NULL.
Comentários
O NDIS usa um objeto genérico para gerenciar recursos alocados por um componente que, de outra forma, não tem um identificador NDIS. Esse componente usa o ponteiro de objeto genérico retornado como um identificador NDIS em algumas APIs de alocação de recursos do NDIS que exigem um identificador NDIS.
Os drivers NDIS devem chamar a função NdisFreeGenericObject para liberar um objeto genérico que foi criado com NdisAllocateGenericObject.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Universal |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis) |