NdisIMCancelInitializeDeviceInstance 함수(ndis.h)

  • 아티클

NdisIMCancelInitializeDeviceInstance 함수는 에 대한 이전 호출을 취소합니다. NdisIMInitializeDeviceInstanceEx 함수입니다.

구문

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  [in] NDIS_HANDLE  DriverHandle,
  [in] PNDIS_STRING DeviceInstance
);

매개 변수

[in] DriverHandle

미니포트 드라이버는 다음을 처리합니다. NdisMRegisterMiniportDriver 함수는 NdisMiniportDriverHandle 매개 변수에서 반환됩니다.

[in] DeviceInstance

시스템 기본 문자 집합에서 호출자가 초기화한 계산 문자열을 설명하는 NDIS_STRING 형식에 대한 포인터입니다. 문자열에는 드라이버가 가상 미니포트 및 바인딩 관련 정보에 대한 정보를 저장하는 레지스트리 키의 이름이 포함됩니다. Microsoft Windows 2000 이상 드라이버의 경우 이 문자열에는 유니코드 문자가 포함되어 있습니다. 즉, Windows 2000 이상의 경우 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

반환 값

NdisIMCancelInitializeDeviceInstance 는 NdisIMInitializeDeviceInstanceEx에 대한 이전 호출을 취소한 경우 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 가상 미니포트에 대한 초기화 작업을 중지할 방법이 없으면 NDIS_STATUS_FAILURE 반환합니다.

설명

중간 드라이버는 다음을 호출합니다. NdisIMInitializeDeviceInstanceEx 함수는 가상 미니포트에 대한 초기화 작업을 시작합니다. NDIS가 드라이버의 MiniportInitializeEx 함수를 호출하기 전에 드라이버는 NdisIMCancelInitializeDeviceInstance 를 호출하여 초기화 작업을 취소할 수 있습니다. 예를 들어 중간 드라이버가 정상 작업에 필요한 기본 드라이버를 제거하면 중간 드라이버는 제거된 드라이버와 연결된 모든 가상 미니포트에 대한 초기화를 취소할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisIMCancelInitializeDeviceInstance(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisIMCancelInitializeDeviceInstance(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼 데스크톱
머리글 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 Irql_IM_Function(ndis)

추가 정보

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING