NdisMInitializeWrapper 매크로(ndis.h)

아티클
08/07/2023

참고 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 를 호출해야 합니다. 일반적으로 이 호출은 반환된 NdisWrapperHandle 다음에 NdisMRegisterMiniport 또는 NdisIMRegisterLayeredMiniport를 호출하는 NIC 드라이버의 DriverEntry 함수의 초기 작업입니다. 또한 NDIS 중간 드라이버는 DriverEntry 함수에서 NdisMInitializeWrapper를 호출한 다음, 반환된 NdisWrapperHandle을 사용하여 NdisMRegisterMiniport 또는 NdisIMRegisterLayeredMiniport를 호출해야 합니다.

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

NdisMInitializeWrapper 호출이 실패하면 NDIS는 변수를 NdisWrapperHandle에서 NULL로 설정합니다. 드라이버는 NdisMInitializeWrapper가 반환된 후 항상 이 변수의 값을 검사 합니다. 값이 NULL이면 드라이버가 DriverEntry 함수 호출에 실패해야 합니다.