AcxCircuitInitAssignAcxRequestPreprocessCallback 函式 (acxcircuit.h)
AcxCircuitInitAssignAcxRequestPreprocessCallback 函式會新增 WDFREQUEST 預處理器回呼。
語法
NTSTATUS AcxCircuitInitAssignAcxRequestPreprocessCallback(
PACXCIRCUIT_INIT CircuitInit,
PFN_ACX_OBJECT_PREPROCESS_REQUEST EvtObjectAcxRequestPreprocess,
ACXCONTEXT DriverContext,
ACX_REQUEST_TYPE RequestType,
const GUID *Set,
ULONG Id
);
參數
CircuitInit
定義線路初始化的 ACXCIRCUIT_INIT 結構。 ACXCIRCUIT_INIT是用於線路初始化的不透明物件。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT結構。
EvtObjectAcxRequestPreprocess
EVT_ACX_OBJECT_PREPROCESS_REQUEST回呼的指標。
DriverContext
ACXCONTEXT 物件所定義的驅動程序內容。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
RequestType
定義不同要求類型的 ACX_REQUEST_TYPE列舉 ，例如 AcxRequestTypeAny、AcxRequestTypeProperty 等。
Set
用來識別特定專案集標識碼的選擇性 GUID。
Id
要縮排指定集合標識碼中特定項目的標識碼。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
驅動程式可以多次叫用此 DDI，以設定不同的前置處理回呼。 ACX 會叫用它找到符合特定傳入 WDFREQUEST 類型的第一個 。
範例
範例使用方式如下所示。
// Render callbacks.
EVT_ACX_OBJECT_PREPROCESS_REQUEST CodecR_EvtCircuitRequestPreprocess;
//
// Add circuit type.
//
AcxCircuitInitSetCircuitType(circuitInit, AcxCircuitTypeRender);
//
// Assign the circuit's pnp-power callbacks.
//
ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT(&powerCallbacks);
powerCallbacks.EvtAcxCircuitPowerUp = CodecR_EvtCircuitPowerUp;
powerCallbacks.EvtAcxCircuitPowerDown = CodecR_EvtCircuitPowerDown;
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks(circuitInit, &powerCallbacks);
//
// Set circuit-callbacks.
//
status = AcxCircuitInitAssignAcxRequestPreprocessCallback(
circuitInit,
CodecR_EvtCircuitRequestPreprocess,
(ACXCONTEXT)AcxRequestTypeAny, // dbg only
AcxRequestTypeAny,
NULL,
AcxItemIdNone);
ACX 需求
最低 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |