Função NdisIMCancelInitializeDeviceInstance (ndis.h)
A função NdisIMCancelInitializeDeviceInstance do cancela uma chamada anterior para o função NdisIMInitializeDeviceInstanceEx.
Sintaxe
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
Parâmetros
[in] DriverHandle
O identificador do driver de miniporto que o função NdisMRegisterMiniportDriver retornada no parâmetro NdisMiniportDriverHandle.
[in] DeviceInstance
Um ponteiro para um tipo de NDIS_STRING que descreve uma cadeia de caracteres contada inicializada pelo chamador no conjunto de caracteres padrão do sistema. A cadeia de caracteres contém o nome da chave do Registro na qual o driver armazena informações sobre um miniporto virtual e, possivelmente, informações específicas da associação. Para drivers do Microsoft Windows 2000 e posteriores, essa cadeia de caracteres contém caracteres Unicode. Ou seja, para o Windows 2000 e posterior, o NDIS define o tipo de NDIS_STRING como um tipo de UNICODE_STRING.
Valor de retorno
NdisIMCancelInitializeDeviceInstance retornará NDIS_STATUS_SUCCESS se cancelou a chamada anterior para NdisIMInitializeDeviceInstanceEx. Caso contrário, ele retornará NDIS_STATUS_FAILURE se não houver como interromper a operação de inicialização para o miniporto virtual.
Observações
Um driver intermediário chama o função NdisIMInitializeDeviceInstanceEx para iniciar a operação de inicialização de um miniporto virtual. Antes que o NDIS chame a função MiniportInitializeEx do driver, o driver pode chamar NdisIMCancelInitializeDeviceInstance para cancelar a operação de inicialização. Por exemplo, se um driver subjacente que o driver intermediário requer para a operação normal for removido, o driver intermediário poderá cancelar a inicialização de quaisquer miniportos virtuais associados ao driver removido.