NetDeviceOpenConfiguration 함수(netdevice.h)
NetDeviceOpenConfiguration 함수는 순 디바이스의 구성 데이터베이스를 엽니다.
구문
NTSTATUS NetDeviceOpenConfiguration(
[_In_] WDFDEVICE Device,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
매개 변수
[_In_] Device
WdfDeviceCreate를 호출하여 클라이언트 드라이버가 이전에 만든 WDFDEVICE 개체입니다.
[_In_opt_] ConfigurationAttributes
새 구성 개체에 대한 드라이버 제공 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.
[_Out_] Configuration
새 NETCONFIGURATION 개체를 수신하는 위치에 대한 포인터입니다.
반환 값
이 함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.
설명
일반적으로 클라이언트는 EVT_WDF_DRIVER_DEVICE_ADD 콜백 함수에서 이 함수를 호출합니다.
클라이언트가 WDF_OBJECT_ATTRIBUTES 제공하는 경우 ParentObject에 대해 NULL을 지정합니다. 디바이스 구성 개체는 디바이스 개체에 자동으로 부모로 설정됩니다.
따라서 WDF는 디바이스가 삭제되면 구성 개체를 자동으로 삭제합니다. 그러나 클라이언트는 일반적으로 EVT_WDF_OBJECT_CONTEXT_CLEANUP 콜백 함수에서 WdfObjectDelete를 호출하여 구성 개체를 수동으로 삭제할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.27 |
| 최소 UMDF 버전 | 2.33 |
| 머리글 | netdevice.h(netadaptercx.h 포함) |
| 라이브러리 | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |