Função NdisIMCancelInitializeDeviceInstance (ndis.h)

  • Artigo

A função NdisIMCancelInitializeDeviceInstance 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 miniporta 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 NDIS_STRING como um tipo de UNICODE_STRING .

Retornar valor

NdisIMCancelInitializeDeviceInstance retorna 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.

Comentários

Um driver intermediário chama o Função NdisIMInitializeDeviceInstanceEx para iniciar a operação de inicialização de miniportos virtuais. 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 exigido pelo driver intermediário para a operação normal for removido, o driver intermediário poderá cancelar a inicialização de quaisquer miniportos virtuais associados ao driver removido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) no Windows XP.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI Irql_IM_Function(ndis)

Confira também

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING