KsFastPropertyHandler 함수(ks.h)
KsFastPropertyHandler 함수는 IOCTL_KS_PROPERTY 통해 빠른 속성 요청을 처리합니다. 빠른 I/O 목록에 포함된 집합에 정의된 모든 속성 식별자에 응답합니다. 이 함수는 PASSIVE_LEVEL 호출할 수 있습니다.
구문
KSDDKAPI BOOLEAN KsFastPropertyHandler(
PFILE_OBJECT FileObject,
PKSPROPERTY Property,
ULONG PropertyLength,
PVOID Data,
ULONG DataLength,
PIO_STATUS_BLOCK IoStatus,
ULONG PropertySetsCount,
const KSPROPERTY_SET *PropertySet
);
매개 변수
FileObject
Property
PropertyLength
Data
DataLength
IoStatus
PropertySetsCount
PropertySet
반환 값
KsFastPropertyHandler 함수는 요청이 처리된 경우 TRUE를 반환하고, 요청이 처리되지 않은 경우 FALSE를 반환합니다. FALSE가 반환되면 IRP가 생성됩니다. 요청이 처리된 경우 함수는 내부 오류로 인해 0으로 설정하거나 속성 처리기를 통해 IoStatus-Information> 요소를 설정합니다. 속성 처리기는 속성이 실제로 처리될 때 IoStatus-Status> 필드도 설정합니다.
설명
속성 집합의 소유자는 디바이스 제어를 위한 빠른 I/O 디스패치 인터페이스를 통해 수행된 요청 처리뿐만 아니라 속성 처리의 사전 필터링 또는 사후 필터링을 수행할 수 있습니다. KsFastPropertyHandler 함수는 신속하게 처리할 수 있는 요청을 처리하는 데만 사용됩니다. 빠른 I/O 함수의 Wait 매개 변수는 전달되지 않으며 TRUE로 간주됩니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
헤더 | ks.h(Ks.h 포함) |
라이브러리 | Ks.lib |