피드백

IoEnumerateDeviceObjectList 함수(ntifs.h)

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

IoEnumerateDeviceObjectList 루틴은 드라이버의 디바이스 개체 목록을 열거합니다.

구문

NTSTATUS IoEnumerateDeviceObjectList(
  [in]  PDRIVER_OBJECT DriverObject,
  [out] PDEVICE_OBJECT *DeviceObjectList,
  [in]  ULONG          DeviceObjectListSize,
  [out] PULONG         ActualNumberDeviceObjects
);

매개 변수

[in] DriverObject

드라이버의 드라이버 개체에 대한 포인터입니다.

[out] DeviceObjectList

디바이스 개체 포인터를 수신하는 호출자가 할당한 배열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] DeviceObjectListSize

DeviceObjectList 배열의 크기(바이트)입니다. 0일 수 있습니다.

[out] ActualNumberDeviceObjects

드라이버 개체의 디바이스 개체 목록에 있는 실제 디바이스 개체 수입니다. DeviceObjectList의 배열이 너무 작으면 배열에 복사되는 디바이스 개체 포인터 수가 ActualNumberDeviceObjects보다 작습니다.

반환 값

IoEnumerateDeviceObjectList 는 다음 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_SUCCESS
 IoEnumerateDeviceObjectList에 대한 호출이 성공했습니다.
STATUS_BUFFER_TOO_SMALL
 DeviceObjectList의 배열이 너무 작아서 전체 디바이스 개체 목록을 저장할 수 없습니다. 이 경우 IoEnumerateDeviceObjectList 는 가능한 한 많은 디바이스 개체 포인터를 배열에 복사합니다.

설명

파일 시스템 필터 드라이버는 IoEnumerateDeviceObjectList 를 호출하여 다음을 열거합니다.

  • 만든 디바이스 개체입니다. 이 작업은 일반적으로 드라이버가 언로드를 준비할 때 수행됩니다. 파일 시스템 필터 드라이버는 실행 중인 시스템에서 안전하게 언로드할 수 없습니다. 자세한 내용은 ZwUnloadDriver를 참조하세요.
  • 기본 파일 시스템에서 만든 디바이스 개체이므로 필터는 연결할 수 있는 볼륨의 수를 알 수 있습니다.
IoEnumerateDeviceObjectList는 드라이버에서 만든 모든 디바이스 개체를 반환합니다. 여기에는 CDO(제어 디바이스 개체) 및 VDO(볼륨 디바이스 개체)가 포함됩니다. 두 가지 유형의 디바이스 개체는 규칙에 따라 CDO의 이름이 지정되고 VDO가 지정되지 않는다는 사실로 구분할 수 있습니다.

후자의 경우 필터 드라이버는 일반적으로 IoEnumerateDeviceObjectList 를 두 번 호출합니다. 한 번은 목록에 있는 디바이스 개체 수를 가져와서 디바이스 개체 목록 자체를 가져옵니다. 첫 번째 호출에서 호출자는 DeviceObjectList 매개 변수를 NULL 로 설정하고 DeviceObjectListSize 를 0으로 설정해야 합니다. 두 번째 호출에서 DeviceObjectList 는 적절한 크기의 포인터 배열에 대한 포인터를 포함해야 하며 DeviceObjectListSize 에는 해당 배열의 크기(바이트)가 포함되어야 합니다.

IoEnumerateDeviceObjectList 는 DeviceObjectList가 가리키는 목록의 모든 디바이스 개체에 대한 참조 수를 증가합니다. 따라서 IoEnumerateDeviceObjectList 에 대한 모든 성공적인 호출은 목록의 각 디바이스 개체에 대해 ObDereferenceObject 에 대한 후속 호출과 일치해야 합니다. 이렇게 하지 않으면 시스템이 미해결 참조 횟수 때문에 이러한 디바이스 개체를 해제하거나 삭제할 수 없습니다.

요구 사항

   
지원되는 최소 클라이언트 이 루틴은 Windows 2000 SP4(서비스 팩 4) 및 Windows XP 이상용 업데이트 롤업에서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

참고 항목

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject

ZwUnloadDriver