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

AcxRequestTypeAny, AcxRequestTypeProperty 등과 같은 다양한 요청 형식을 정의하는 ACX_REQUEST_TYPE 열 거형입니다.

Set

특정 항목 집합 ID를 식별하는 선택적 GUID입니다.

Id

지정된 집합 ID의 특정 항목을 들여쓰는 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

추가 정보