NdisWriteConfiguration 함수(ndis.h)

아티클
08/07/2023

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 키워드 는 값 항목 이름의 동의어입니다. 이러한 이름은 NUL로 종료된 유니코드 문자의 계산된 시퀀스입니다.

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)