NdisWriteConfiguration 함수(ndis.h)
NdisWriteConfiguration 함수는 레지스트리에 지정된 항목에 대해 호출자가 제공한 값을 씁니다. 이 함수는 자체 및 NdisReadConfiguration 함수와 관련하여 직렬로 호출되어야 합니다.
구문
void NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
매개 변수
[out] Status
이 함수가 호출 상태를 다음 중 하나로 반환하는 호출자 제공 변수에 대한 포인터입니다.
NDIS_STATUS_SUCCESS
ParameterValue에서 제공된 값이 레지스트리에 기록되었습니다. 새 항목인 경우 키워드 의 이름도 레지스트리에 기록되었습니다.
NDIS_STATUS_NOT_SUPPORTED
제공된 ParameterType 이 잘못되었습니다.
NDIS_STATUS_RESOURCES
NDIS는 요청된 정보를 레지스트리로 전송하기 위해 리소스(일반적으로 충분한 메모리)를 할당할 수 없습니다.
NDIS_STATUS_FAILURE
요청된 정보를 쓸 수 없습니다.
[in] ConfigurationHandle
NdisOpenConfigurationEx에서 반환된 레지스트리 키에 대한 핸들입니다. NdisOpenConfigurationKeyByIndex 또는 NdisOpenConfigurationKeyByName 함수입니다.
[in] Keyword
시스템 기본 문자 집합에서 호출자가 제공한 개수 문자열을 설명하는 NDIS_STRING 형식에 대한 포인터로, 값을 쓸 항목의 이름을 지정합니다. Microsoft Windows 2000 이상 드라이버의 경우 이 문자열에는 유니코드 문자가 포함됩니다. 즉, Windows 2000 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.
[in] ParameterValue
호출자가 제공한 포인터 NDIS_CONFIGURATION_PARAMETER 구조체입니다.
반환 값
없음
설명
키 워드 와 동일한 이름의 항목이 열려 있는 레지스트리 키 아래에 이미 있는 경우 NdisWriteConfiguration 은 현재 값을 호출자 제공 값으로 바꿉니다. 그렇지 않으면 NdisWriteConfiguration 은 지정된 이름과 제공된 값을 사용하여 새 값 항목을 레지스트리에 추가합니다.
Windows 2000 이상 버전의 구성 레지스트리에서 NDIS 키워드 는 값 항목 이름의 동의어입니다. 이러한 이름은 null 문자로 종료되는 유니코드 문자의 계산된 시퀀스입니다.
NdisWriteConfiguration 은 Keyword 에서 호출자가 제공한 문자열을 버퍼링하고 복사하고 ParameterValue 에 지정된 호출자 제공 데이터를 복사합니다. 이 메모리는 드라이버가 NdisCloseConfiguration 함수를 사용하여 ConfigurationHandle을 해제할 때 해제됩니다. NdisWriteConfiguration의 호출자는 키워드 및 에 할당된 메모리에서 버퍼링된 문자열을 해제하는 역할을 합니다. NDIS_CONFIGURATION_PARAMETER 구조체입니다.
NdisWriteConfiguration을 호출하는 대신, 모든 NDIS 드라이버는 드라이버의 INF 파일에서 AddReg 지시문을 사용하여 레지스트리에서 구성 정보를 직접 설정할 수 있습니다.
Windows 2000 이상 버전의 설치 및 설치 파일에 대한 자세한 내용은 디바이스 설치 개요를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisWriteConfiguration(NDIS 5.1 참조))에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisWriteConfiguration(NDIS 5.1) 참조)에 대해 지원됩니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ndis.h(Ndis.h 포함) |
| 라이브러리 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | Irql_Miscellaneous_Function(ndis) |