Macro NdisMInitializeWrapper (ndis.h)

Artigo
02/26/2024

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter o novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

NdisMInitializeWrapper notifica o NDIS de que um novo driver de miniporto está inicializando.

Sintaxe

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Parâmetros

[out] _a

Ponteiro para uma variável fornecida pelo chamador na qual o NDIS retorna um identificador que representa a si mesmo. Se a chamada para NdisMInitializeWrapper falhar, o NDIS definirá a variável em NdisWrapperHandle como NULL.

[in] _b

Especifica um ponteiro de um tipo específico do sistema.

Para drivers windows 2000 e posteriores, esse é um ponteiro para uma entrada de objeto de driver opaco para a função DriverEntry do driver de miniport.

[in] _c

Especifica um ponteiro de um tipo específico do sistema.

Para drivers windows 2000 e posteriores, esse é um ponteiro para uma entrada de caminho de registro opaco para a função DriverEntry do driver de miniport.

[in] _d

Especifica um ponteiro de um tipo específico do sistema.

Para drivers windows 2000 e posteriores, esse ponteiro deve ser definido como NULL quando o driver de miniporto chamar NdisMInitializeWrapper.

Retornar valor

Nenhum

Comentários

Um driver NIC ou driver intermediário deve chamar NdisMInitializeWrapper antes de chamar qualquer outra função NdisXxx. Normalmente, essa chamada é a ação inicial da função DriverEntry de qualquer driver NIC, que chama NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport com o NdisWrapperHandle retornado em seguida. Os drivers intermediários do NDIS também devem chamar NdisMInitializeWrapper da função DriverEntry e, em seguida, chamar NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport com o NdisWrapperHandle retornado.

Essas chamadas subsequentes de um driver para funções de inicialização e configuração do NdisXxx devem passar o NdisWrapperHandle como um parâmetro. Consequentemente, é um parâmetro de entrada para a função MiniportInitialize .

Se a chamada para NdisMInitializeWrapper falhar, o NDIS definirá a variável em NdisWrapperHandle como NULL. O driver deve sempre marcar o valor dessa variável após o retorno de NdisMInitializeWrapper. Se o valor for NULL, o driver deverá falhar na chamada para a função DriverEntry .