NdisMRegisterDevice

NDIS_STATUS NdisMRegisterDevice( IN NDIS_HANDLE NdisWrapperHandle, IN PNDIS_STRING DeviceName, IN PNDIS_STRING SymbolicName, IN PDRIVER_DISPATCH MajorFunctions[], OUT PDEVICE_OBJECT *pDeviceObject, OUT NDIS_HANDLE *NdisDeviceHandle );

NdisMRegisterDevice 함수는 장치 객체와 장치 객체와 그 장치를 위한 사용자 쪽 이름 사이에 이름을 가진 심볼릭 링크를 만든다.

매개변수

NdisWrapperHandle

NdisMInitializeWrapper에 의해 리턴된 핸들을 지정한다.

DeviceName

장치 객체를 가리키는 0으로 끝나는 유니코드 문자열을 포함하는 버퍼를 가리킨다. 문자열은 완전한 패스 이름을 가진다. 예로 \Device\DeviceName

SymbolicName

등록된 장치의 Win32에서 사용하는 이름을 나타내는 버퍼화된 유니코드 문자열을 가리킨다. 전형적으로 SymbolicName은 다음과 같은 포맷을 가진다. \DosDevices\SymbolicName.

MajorFunctions

장치 드라이버의 디스패치 루틴들을 위한 하나나 그 이상의 엔트리 포인트들의 배열을 가리킨다. 드라이버는 드라이버가 장치 객체를 위해 다루는 IRP_MJ_XXX코드들과 같은 많은 다른 디스패치 엔트리 포인트들을 설정해야 한다. 각 디스패치 루틴들은 다음과 같이 선언되어진다.

NTSTATUS

(*PDRIVER_DISPATCH) (

    IN PDEVICE_OBJECT Device Object,

    IN PIRP Irp

);

드라이버는 만들어진 객체가 실제 장치가 아니고 그러므로 플러그 앤 플레이나 파워 관리 IRP들을 받을 수 없기 때문에 플러그앤플레이와 전원관리 핸들러를 위한 엔트리 포인트들을 제공하지 않는다.

pDeviceObject

만약 호출이 성공적이면은 새롭게 만들어진 장치 객체를 가리킨다.

NdisDeviceHandle

만약 성공적이다면은 장치 객체에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다. 이 핸들은 드라이버가 나중에 호출하는 NdisMDeregisterDevice 함수에 필요한 매개변수이다.

리턴값

NdisMRegisterDevice는 만약 성공한다면은 STATUS_SUCCESS를 리턴하고 호출자가 NDIS 미니포트가 아니면은 NDIS_STATUS_NOT_SUPPORTED이고 실패하면은 실패 코드이다.

주석

인터미디엇 드라이버나 혹은 미니포트 드라이버는 분리된 혹은 혼자의(stand-alone) 장치 객체를 요구할 것이다. 예를 들어, 인터미디엇 미니포트는 stand-alone 장치 객체들이 NIC 미니포트가 up되지 않고 실행할 때 아래 NIC에 상태를 모니터하기 위해 요구되어진다. 그러한 경우에 NIC 상태를 얻기 위해 사용자 모드 어플리케이션 혹은 환경적인 서브 시스템은 IRP를 장치 객체에 보낸다. IRP는 인터미디엇 드라이버에 의해 처리되어진다. stand-alone 장치 객체 없이 NIC의 상태는 단지 NIC 미니포트가 up되고 실행될 때 이용할 수 있다.

인터미디엇 드라이버나 미니포트는 DriverEntry가 NdisMInitializeWrapper를 호출한 후 DriverEntry 함수로부터 NdisMRegisterDevice를 호출함으로써 장치 객체를 만든다. NdisMRegisterDevice는 이름을 가진 장치 객체를 만들고 또한 장치 객체 이름과 그 장치에 대한 사용자가 사용하는 이름 사이에 심볼릭 연결을 만든다. NdisMRegisterDevice에 대한 호출이 성공적이면은, I/O 매니저는 장치 객체를 위해 그리고 드라이버 확장 내용들을 (Device Extension) 포함한 장치 객체와 관련된 모든 다른 데이터 구조체을 위해 비페이지화된 pool내에 저장 공간을 할당한다. NdisMRegisterDevice로 만들어진 객체를 위한 장치 확장은 NDIS에 의해 사용이 예약되었고 드라이버에 의해 사용될 수 없다.

NdisMRegisterDevice로 만들어진 객체는 IoCreateDevice와 IoCreateSymbolicLink로 각가 만들어진 장치 객체와 심볼릭 링크와 같은 기능을 한다. 장치 객체에 보내지는 IRP들은 NDIS가 아니라 장치 객체를 만든 드라이버에 의해 처리되어진다. 드라이버는 NdisMRegisterDevice의 MajorFunctions 포인터에 제공될 때 등록되어지는 디스패치 루틴들을 사용하여 장치 객체에 보내진 IRP들을 처리한다. 장치 객체들, IRP들, 디스패치 루틴들에 대한 더 자세한 정보는 Kernel-mode Driver Design Guide를 보라.

NDIS 드라이버들은 결코 IoCreateDevice 혹은 IoCreateSymbolicLink을 호출하면은 안된다. 그 대신에 NDIS 드라이버는 장치 객체를 만들 때 NdisMRegisterDevice를 호출해야 한다.

NdisMRegisterDevice에 의해 만들어진 장치 객체는 실제 장치 객체가 아니므로 Plug and Play나 혹은 파워 관리 IRP들을 수신하지 않는다. NdisMRegisterDevice 호출자는 그러므로 MajorFunctions에 의해 가리키는 배열내에 PnP와 파워 관리 핸들러를 위해 엔트리 포인트들은 빠져야 한다.

만약 NdisMRegisterDevice에 대한 호출이 실패한다면은, 드라이버는 stand-alone 장치 객체가 드라이버 연산을 위해 얼마나 크리티컬하는지에 따라 계속해서 로드될 수 있고 그렇지 않을 수 있다.

NdisMRegisterDevice의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.