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。 如果已處理要求,函式會設定 IoStatus->Information 元素,可能是因為內部錯誤而將它設定為零,或透過屬性處理程式設定它。 當實際處理屬性時,屬性處理程式也會設定IoStatus->Status 字段。
言論
屬性集的擁有者可以執行屬性處理的預先篩選或後置篩選,以及透過裝置控件的快速 I/O 分派介面所進行的處理要求。 KsFastPropertyHandler 函式僅用於處理可快速完成的要求。 不會傳遞快速 I/O 函式 Wait 參數,並假設為 true 。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |