Macro NdisMInitializeWrapper (ndis.h)
Observação NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter um 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 o 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á sendo inicializado.
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, este é um ponteiro para uma entrada de objeto de driver opaco para a função DriverEntry do driver do miniport.
[in] _c
Especifica um ponteiro de um tipo específico do sistema.
Para drivers windows 2000 e posteriores, este é um ponteiro para uma entrada opaca do caminho do Registro para a função DriverEntry do driver do 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 chama NdisMInitializeWrapper.
Valor de retorno
Nenhum
Observações
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 a seguir. Os drivers intermediários do NDIS também devem chamar NdisMInitializeWrapper da função DriverEntry e, em seguida, chamar NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport com o retornado NdisWrapperHandle.
Essas chamadas subsequentes de um driver para funções de inicialização e configuração do NdisXxx devem passar o NdisWrapperHandle como 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 para NULL. O driver sempre deve verificar o valor dessa variável depois que NdisMInitializeWrapper retorna. Se o valor for NULL, o driver deverá falhar na chamada para a função DriverEntry.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ndis.h |
| IRQL | PASSIVE_LEVEL |
Consulte também
inicializando um de driver de miniporto