NetConfigurationOpenSubConfiguration 함수(netconfiguration.h)
지정된 어댑터 구성 개체의 하위 구성을 엽니다.
통사론
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
매개 변수
[_In_] Configuration
NetAdapterOpenConfiguration 또는 NetConfigurationOpenSubConfiguration 이전 호출에서 열린 어댑터 구성 개체에 대한 핸들입니다.
[_In_] SubConfigurationName
열 하위 구성의 이름을 지정하는 문자열에 대한 포인터입니다.
[_In_opt_] SubConfigurationAttributes
새 구성 개체에 대한 드라이버 제공 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.
[_Out_] SubConfiguration
새 하위 구성 개체에 대한 핸들을 받는 위치에 대한 포인터입니다.
반환 값
함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.
발언
클라이언트가 WDF_OBJECT_ATTRIBUTES제공하는 경우 ParentObject대한 NULL 지정합니다. 기본적으로 하위 구성은 기존 어댑터 구성 개체에 부모로 지정됩니다.
클라이언트 드라이버는 하위 구성 개체 또는 부모 어댑터 구성 개체를 사용하여 NetConfigurationClose 호출하여 하위 구성을 닫습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.21 |
| 최소 UMDF 버전 | 2.33 |
| 헤더 | netconfiguration.h(netadaptercx.h 포함) |
| 라이브러리 | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |