NdisIMInitializeDeviceInstance
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função chama um intermediário NDIS do driver MiniportInitialize função configurar o driver do NIC virtual para operações E/S em um subjacente NIC driver ao qual o intermediário driver está ligado.
Syntax
NDIS_STATUS NdisIMInitializeDeviceInstance(
NDIS_HANDLE DriverHandle,
PNDIS_STRING DeviceInstance
);
Parameters
- DriverHandle
[no] Especifica o identificador retornado por NdisIMRegisterLayeredMiniport.
- DeviceInstance
[no] Aponta para um armazenada em buffer, Caller-initialized seqüência de caracteres, contados no sistema-conjunto de caracteres usar como padrão, nomeação a chave Registro no qual o driver armazena informações sobre seu NIC virtual e, possivelmente, informações Binding-specific.
Return Value
A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
O intermediário do driver virtual NIC foi inicializado com êxito. |
NDIS_STATUS_NOT_ACCEPTED |
NdisIMInitializeDeviceInstanceEx falha porque o dispositivo especificado por DriverHandle já foi inicializado. |
Remarks
Um intermediário NDIS driver geralmente chamadas NdisIMInitializeDeviceInstance Ou NdisIMInitializeDeviceInstanceEx do seu ProtocolBindAdapter função.
Script instalação do driver criado a chave designado por DeviceInstance Na árvore de Registro configuração.
Antes de ele chama NdisIMInitializeDeviceInstance, ProtocolBindAdapter Faça um bem-sucedido chamar para NdisOpenAdapter, assim, ligação o intermediário driver para o subjacente driver NIC. Em seguida, seu chamar subseqüente para NdisIMInitializeDeviceInstance Permite que do o driver MiniportInitialize função alocar todos os recursos de driver precisa executar sem rede E/S operações e para inicializar o driver do NIC virtual, aos quais drivers protocolo de nível superior podem BIND próprios quando o intermediário NDIS inicialização do driver está completo.
Requirements
| Header | ndis.h |
| Library | ndis.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
MiniportInitialize
NdisIMDeInitializeDeviceInstance
NdisIMInitializeDeviceInstanceEx
NdisIMRegisterLayeredMiniport
NdisInitializeString
NdisOpenAdapter