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 driver a ser associado ao objeto genérico. Esse 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 de 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.
Valor de retorno
NdisAllocateGenericObject retorna um ponteiro para o NDIS_GENERIC_OBJECT alocado. Se o NDIS não tiver criado o objeto, o valor retornado será NULL.
Observações
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 criado com NdisAllocateGenericObject.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis) |