NdisRegisterDeviceEx 함수(ndis.h)
NdisRegisterDeviceEx 함수는 지정된 특성을 기반으로 하는 디바이스 개체를 만듭니다.
구문
NDIS_STATUS NdisRegisterDeviceEx(
[in] NDIS_HANDLE NdisHandle,
[in] PNDIS_DEVICE_OBJECT_ATTRIBUTES DeviceObjectAttributes,
[out] PDEVICE_OBJECT *pDeviceObject,
[out] PNDIS_HANDLE NdisDeviceHandle
);
매개 변수
[in] NdisHandle
호출자가 를 호출하여 가져온 미니포트 드라이버 핸들 또는 필터 드라이버 핸들 NdisMRegisterMiniportDriver 함수 또는 NdisFRegisterFilterDriver 함수는 각각 NdisFRegisterFilterDriver 함수입니다.
[in] DeviceObjectAttributes
에 대한 포인터 새 디바이스의 특성을 포함하는 NDIS_DEVICE_OBJECT_ATTRIBUTES 구조체입니다.
[out] pDeviceObject
호출이 성공하면 새로 만든 DEVICE_OBJECT 구조체에 대한 포인터를 가리키는 포인터입니다. 호출이 실패하면 pDeviceObject 가 NULL을 가리키도록 설정됩니다.
[out] NdisDeviceHandle
이 함수가 성공하면 디바이스 개체에 대한 핸들을 반환하는 호출자 제공 변수에 대한 포인터입니다. 이 핸들은 드라이버가 이후에 호출하는 NdisDeregisterDeviceEx 함수에 필요한 매개 변수입니다.
반환 값
NdisRegisterDeviceEx는 다음 상태 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
NdisRegisterDeviceEx 가 디바이스를 성공적으로 등록했습니다. |
|
호출자가 NDIS 드라이버가 아닙니다. |
|
디바이스를 등록하려는 드라이버의 시도가 실패했습니다. 일반적으로 이러한 오류 상태 NdisXxx 함수 또는 커널 모드 지원 루틴에서 전파됩니다. |
설명
미니포트 드라이버 및 필터 드라이버는 NdisRegisterDeviceEx 를 호출하여 가상 디바이스를 등록할 수 있습니다.
디바이스가 더 이상 필요하지 않은 경우 드라이버는 이후에 NdisDeregisterDeviceEx 함수를 호출해야 합니다. NdisRegisterDeviceEx에서 확장을 할당한 경우 NdisDeregisterDeviceEx는 확장을 해제합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
대상 플랫폼 | 유니버설 |
헤더 | ndis.h(Ndis.h 포함) |
라이브러리 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 규정 준수 규칙 | Irql_Miscellaneous_Function(ndis) |