共用方式為

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。

規格需求

需求 值
目標平台 Universal
標頭 ks.h (包含 Ks.h)
程式庫 Ks.lib

另請參閱

KsPropertyHandler