다음을 통해 공유


NetAdapterInitAllocate 함수(netadapter.h)

NetAdapterInitAllocate 함수는 클라이언트 드라이버가 새 NETADAPTER 개체를 만들 때 사용하는 NETADAPTER_INIT 구조를 할당합니다.

통사론

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

매개 변수

[_In_] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

작업이 성공하면 프레임워크 할당 NETADAPTER_INIT 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 이 함수는 NULL반환합니다.

중요하다

클라이언트 드라이버가 이 함수에 대한 성공적인 호출에서 NETADAPTER_INIT 구조를 수신하는 경우 드라이버는 항상 NetAdapterInitFree 호출하여 NetAdapterCreate결과에 관계없이 할당을 취소해야 합니다.

발언

클라이언트 드라이버는 NetAdapterInitAllocate 호출하여 NetAdapterCreate전달할 수 있는 NETADAPTER_INIT 구조를 가져옵니다.

NetAdapterInitAllocate 성공하면 클라이언트 드라이버는 필요에 따라 NetAdapterInitSetXxx 함수를 호출하여 NETADAPTER에 대한 추가 초기화 특성을 설정할 수 있습니다.

NETADAPTER를 만드는 코드 예제는 디바이스 초기화참조하세요.

요구 사항

요구
대상 플랫폼 보편적
최소 KMDF 버전 1.27
최소 UMDF 버전 2.33
헤더 netadapter.h(netadaptercx.h 포함)
라이브러리 netadaptercxstub.lib
IRQL PASSIVE_LEVEL

참고 항목

디바이스 초기화

netAdapterCreate

NetAdapterInitFree