Função NdisIMCancelInitializeDeviceInstance (ndis.h)

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

Confira também

MiniportInitializeEx

NdisMRegisterMiniportDriver

UNICODE_STRING