Share via

NetAdapterOpenConfiguration 함수(netadapter.h)

  • 아티클

NetAdapterOpenConfiguration 함수는 net 어댑터의 구성 데이터베이스를 엽니다.

구문

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

매개 변수

[_In_] Adapter

NetAdapterCreate에 대한 이전 호출에서 클라이언트가 만든 네트워크 어댑터 개체입니다.

[_In_opt_] ConfigurationAttributes

새 구성 개체에 대해 드라이버 제공 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.

[_Out_] Configuration

새 어댑터 구성 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다.

반환 값

함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

일반적으로 클라이언트는 EVT_WDF_DRIVER_DEVICE_ADD 콜백 함수에서 이 함수를 호출합니다.

클라이언트가 WDF_OBJECT_ATTRIBUTES 제공하는 경우 ParentObject에 대해 NULL을 지정합니다. 어댑터 구성 개체는 어댑터 개체에 자동으로 부모로 지정됩니다.

따라서 WDF는 어댑터가 삭제되면 구성 개체를 자동으로 삭제합니다. 그러나 클라이언트는 일반적으로 EVT_WDF_OBJECT_CONTEXT_CLEANUP 콜백 함수에서 WdfObjectDelete를 호출하여 구성 개체를 수동으로 삭제할 수 있습니다.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.21
머리글 netadapter.h(netadaptercx.h 포함)
라이브러리 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

추가 정보

구성 정보 액세스

NetConfigurationClose