NdisOpenProtocolConfiguration 함수(ndis.h)

  • 아티클

참고 NDIS 5. x 는 더 이상 사용되지 않으며 NDIS 6으로 대체됩니다. x. 새로운 NDIS 드라이버 개발은 Windows Vista부터 시작하는 네트워크 드라이버를 참조하세요. NDIS 5 포팅에 대한 자세한 내용입니다. x 드라이버를 NDIS 6에 연결합니다. x, NDIS 5.x 드라이버를 NDIS 6.0으로 포팅을 참조하세요.

NdisOpenProtocolConfiguration 은 프로토콜 드라이버의 어댑터별 정보가 저장되는 레지스트리 키에 대한 핸들을 반환합니다.

구문

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

매개 변수

[out] Status

이 함수에서 반환할 때 NDIS_STATUS_SUCCESS 또는 오류 상태 설정된 호출자 제공 변수에 대한 포인터입니다.

[out] ConfigurationHandle

이 함수가 호출자가 나중에 자신을 바인딩할 명명된 미니포트 드라이버의 레지스트리 키에 대한 핸들을 반환하는 호출자 제공 변수에 대한 포인터입니다. 이 키 아래의 값 항목에는 프로토콜 설치 어댑터 관련 정보가 포함됩니다.

[in] ProtocolSection

시스템 기본 문자 집합에 지정된 계산된 문자열을 포함하는 호출자가 제공한 NDIS_STRING 형식에 대한 포인터입니다. 이 계산된 문자열은 NDIS NIC 드라이버의 이름을 사실상 어댑터로 지정하며, 레지스트리 프로토콜 섹션에서 어댑터별 매개 변수 키를 열어야 합니다. Windows 2000 이상 프로토콜의 경우 계산된 이 문자열에는 유니코드 문자가 포함됩니다. 즉, Windows 2000 이상의 경우 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

이 포인터는 호출자의 ProtocolBindAdapter 함수에 대한 SystemSpecific1 입력 매개 변수입니다.

반환 값

없음

설명

NdisOpenProtocolConfiguration 은 호출자가 이후에 Ndis에 전달할 수 있는 핸들을 반환 합니다. 레지스트리에 정보를 검색하거나 저장하는 구성 함수입니다.

프로토콜 드라이버는 NdisOpenProtocolConfiguration 을 호출하여 나중에 다른 Ndis에 전달할 레지스트리 키 핸들을 가져옵니다. 설치 파일이 프로토콜이 바인딩을 설정하는 레지스트리의 프로토콜 섹션에 어댑터별 구성 정보를 저장한 경우 NdisRead/WriteConfiguration 또는 NdisOpenConfigurationKeyByName/Index와 같은 구성 함수입니다.

프로토콜은 NdisOpenConfigurationKeyByName 또는 NdisOpenConfigurationKeyByIndex 를 호출하여 NdisOpenProtocolConfiguration 이 핸들을 반환하는 레지스트리 키의 하위 키를 열 수 있습니다.

Windows 2000 이상 프로토콜은 커널 모드 지원 루틴을 호출하여 자체 프로토콜별 레지스트리 키를 엽니다. 이러한 지원 루틴에 대한 자세한 내용은 Kernel-Mode 지원 루틴 및 전원 관리 지원 루틴 요약을 참조하세요.

  • 대상 플랫폼: 유니버설
  • 버전: Windows Vista의 NDIS 6.0 드라이버에는 지원되지 않습니다. 대신 NdisOpenConfigurationEx를 사용합니다. Windows Vista 및 Windows XP에서 NDIS 5.1 드라이버에 대해 지원됩니다.

요구 사항

요구 사항 값
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL

추가 정보