Compartilhar via

Função NdisAllocateGenericObject (ndis.h)

  • Artigo

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)

Confira também

NDIS_GENERIC_OBJECT

NdisFreeGenericObject