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

另請參閱