피드백

NdisMRegisterWdiMiniportDriver 함수(dot11wdi.h)

  • 아티클
  • 읽는 데 3분 걸림

중요

이 항목은 Windows 10 릴리스된 WDI 드라이버 모델의 일부입니다. WDI 드라이버 모델은 유지 관리 모드이며 높은 우선 순위 수정만 받습니다. WiFiCx는 Windows 11 출시된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다.

미니포트 드라이버는 NdisMRegisterWdiMiniportDriver 함수를 호출하여 초기화의 첫 번째 단계로 MiniportWdiXxx 진입점을 NDIS에 등록합니다.

구문

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

매개 변수

[in] DriverObject

Argument1 매개 변수의 DriverEntry 루틴에서 미니포트 드라이버가 받은 불투명 드라이버 개체에 대한 포인터입니다(NDIS 미니포트 드라이버의 DriverEntry 참조).

[in] RegistryPath

Miniport 드라이버가 Argument2 매개 변수의 DriverEntry 루틴에서 받은 불투명 레지스트리 경로에 대한 포인터입니다.

[in, optional] NdisDriverContext

드라이버가 상태 및 구성 정보를 유지하는 드라이버 할당 컨텍스트 영역에 대한 핸들입니다.

[in] MiniportDriverCharacteristics

호출자가 초기화한 NDIS_MINIPORT_DRIVER_CHARACTERISTICS 구조체에 대한 포인터입니다.

[in] MiniportWdiCharacteristics

호출자가 초기화한 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS 구조체에 대한 포인터입니다.

[out] NdisMiniportDriverHandle

호출자가 제공한 핸들 변수에 대한 포인터입니다. NDIS는 이 드라이버를 고유하게 식별하는 핸들을 이 변수에 씁니다. 드라이버는 후속 NdisXxx 함수 호출에서 사용하기 위해 이 핸들을 저장해야 합니다.

반환 값

NdisMRegisterWdiMiniportDriver는 다음 반환 값 중 어느 것을 반환할 수 있습니다.

반환 코드 설명
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver는 WDI 미니포트 드라이버를 성공적으로 등록했습니다.
NDIS_STATUS_BAD_CHARACTERISTICS
 CharacteristicsLength 매개 변수가 MiniportDriverCharacteristics 구조체의 MajorNdisVersion 멤버에 지정된 NDIS 버전에 대해 올바르지 않습니다.
NDIS_STATUS_BAD_VERSION
 특성 구조에 지정된 MajorNdisVersion 또는 MinorNdisVersion 이 잘못되었습니다.
NDIS_STATUS_RESOURCES
 리소스가 부족하여 메모리가 부족하여 NDIS가 호출자를 등록하지 못했습니다.
NDIS_STATUS_FAILURE
 이전 오류 중 어느 것도 등록에 실패하지 않은 경우 반환되는 기본 오류 상태입니다.
기타 NDIS_STATUS 코드
 오류가 발생한 경우 적절한 NDIS_STATUS 코드입니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 dot11wdi.h
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL

참고 항목

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS