WdfFdoLockStaticChildListForIteration 함수(wdffdo.h)
[KMDF에만 적용]
WdfFdoLockStaticChildListForIteration 메서드는 지정된 부모 디바이스에 속하는 정적 자식 목록에서 항목을 검색하기 위한 프레임워크를 준비합니다.
구문
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
매개 변수
[in] Fdo
부모 디바이스를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
없음
설명
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
정적 버스 열거형을 사용하는 버스 드라이버는 WdfFdoLockStaticChildListForIteration을 호출할 수 있습니다.
WdfFdoLockStaticChildListForIteration을 호출한 후 드라이버는 WdfFdoRetrieveNextStaticChild를 반복적으로 호출하여 자식 목록의 각 자식 디바이스에 대한 정보를 가져올 수 있습니다.
드라이버가 WdfFdoRetrieveNextStaticChild 호출을 완료한 후 WdfFdoUnlockStaticChildListFromIteration을 호출해야 합니다.
드라이버가 WdfFdoLockStaticChildListForIteration을 호출한 후 자식 목록을 변경하는 경우 프레임워크는 모든 변경 내용을 저장하고 드라이버가 WdfFdoUnlockStaticChildListFromIteration을 호출할 때 변경 내용을 PnP(플러그 앤 플레이) 관리자에게 알릴 수 있습니다.
드라이버는 WdfFdoLockStaticChildListForIteration 및 WdfFdoUnlockStaticChildListFromIteration에 대한 호출을 중첩할 수 있습니다. 드라이버가 이러한 메서드에 대한 호출을 중첩하는 경우 프레임워크는 WdfFdoUnlockStaticChildListFromIteration에 대한 마지막 호출까지 모든 변경 내용을 저장합니다.
정적 자식 목록에 대한 자세한 내용은 정적 열거형을 참조하세요.
예제
WdfFdoLockStaticChildListForIteration을 사용하는 코드 예제는 WdfFdoRetrieveNextStaticChild를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 머리글 | wdffdo.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |