NdisMInitializeWrapper 매크로(ndis.h)

아티클
02/07/2025

참고 NDIS 5. x 더 이상 사용되지 않으며 NDIS 6으로 대체됩니다. x . 새로운 NDIS 드라이버 개발은 Windows Vista 시작하는네트워크 드라이버를 참조하세요. NDIS 5 포팅에 대한 자세한 내용입니다. x 드라이버를 NDIS 6에. x NDIS 5.x 드라이버를 NDIS 6.0 참조하세요.

NdisMInitializeWrapper는 NDIS에 새 미니포트 드라이버가 초기화 중임을 알 수 있습니다.

통사론

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

매개 변수

[out] _a

NDIS가 자신을 나타내는 핸들을 반환하는 호출자 제공 변수에 대한 포인터입니다. NdisMInitializeWrapper 호출에 실패하면 NDIS는 NdisWrapperHandle의 변수를 NULL 설정합니다.

[in] _b

시스템별 형식의 포인터를 지정합니다.

Windows 2000 이상 드라이버의 경우 미니포트 드라이버의 DriverEntry 함수에 대한 불투명 드라이버 개체 입력에 대한 포인터입니다.

[in] _c

시스템별 형식의 포인터를 지정합니다.

Windows 2000 이상 드라이버의 경우 미니포트 드라이버의 DriverEntry 함수에 대한 불투명 레지스트리 경로 입력에 대한 포인터입니다.

[in] _d

시스템별 형식의 포인터를 지정합니다.

Windows 2000 이상 드라이버의 경우 미니포트 드라이버가 NdisMInitializeWrapper호출할 때 이 포인터는 NULL 설정해야 합니다.

반환 값

없음

발언

NIC 드라이버 또는 중간 드라이버는 다른 NdisXxx 함수를 호출하기 전에 NdisMInitializeWrapper 호출해야 합니다. 일반적으로 이 호출은 NdisMRegisterMiniport또는 NdisIMRegisterLayeredMiniport 다음에 반환된NdisWrapperHandle 호출하는 NIC 드라이버의 DriverEntry 함수의 초기 작업입니다. 또한 NDIS 중간 드라이버는 DriverEntry 함수에서 NdisMInitializeWrapper 호출한 다음 반환된 NdisWrapperHandle사용하여 NdisMRegisterMiniport 또는 NdisIMRegisterLayeredMiniport 호출해야 합니다.

이러한 드라이버의 NdisXxx 초기화 및 구성 함수에 대한 후속 호출은 NdisWrapperHandle 매개 변수로 전달해야 합니다. 따라서 MiniportInitialize 함수에 대한 입력 매개 변수입니다.

NdisMInitializeWrapper 호출에 실패하면 NDIS는 NdisWrapperHandle 변수를 NULL 설정합니다. 드라이버는 NdisMInitializeWrapper 반환한 후에 항상 이 변수의 값을 확인해야 합니다. 값이 NULL 경우 드라이버는 DriverEntry 함수에 대한 호출에 실패해야 합니다.