KsMethodHandlerWithAllocator 函式會執行與 KsMethodHandler相同的處理,但允許選擇性配置器回呼用來提供參數的緩衝區。 如果使用,篩選條件可能需要以某種非常規方式釋放緩衝區。 請注意,使用自定義配置器時,不會設定IRP_BUFFERED_IO和IRP_DEALLOCATE_BUFFER旗標。
語法
KSDDKAPI NTSTATUS KsMethodHandlerWithAllocator(
[in] PIRP Irp,
[in] ULONG MethodSetsCount,
[in] const KSMETHOD_SET *MethodSet,
[in, optional] PFNKSALLOCATOR Allocator,
[in, optional] ULONG MethodItemSize
);
參數
[in] Irp
使用所處理的方法要求來指定 IRP。
[in] MethodSetsCount
表示要傳遞的方法集結構數目。
[in] MethodSet
指定方法集資訊清單的指標。
[in, optional] Allocator
選擇性地指向將用來配置記憶體以儲存方法參數的配置函式。
[in, optional] MethodItemSize
選擇性地包含每個方法清單中每個KSMETHOD_ITEM結構的大小。 方法專案可以擴充,以便儲存私用資訊。 如果此參數為零,則會假設結構大小為一般。 如果大於或等於方法項目結構,則KSMETHOD_ITEM_IRP_STORAGE巨集可用來傳回方法專案的指標,以便擷取自定義數據。 在 64 位平臺上,此參數必須是 8 的倍數。
傳回值
KsMethodHandler 函式會在成功時傳回STATUS_SUCCESS,或失敗時處理的方法特定錯誤。 函式一律會設定IO_STATUS_BLOCK。PIRP 的資訊欄位。IRP 內的 IoStatus 元素因為內部錯誤而設為零,或專案是由方法處理程式所設定。 函式不會設定IO_STATUS_BLOCK。狀態欄位或完成 IRP。
在 64 位平臺上,如果 PropertyItemSize 參數不是 8 的倍數,則會傳回STATUS_INVALID_PARAMETER,而且呼叫失敗。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |