AcxTargetPinFormatRequestForMethod 함수(acxtargets.h)

  • 아티클

AcxTargetPinFormatRequestForMethod 함수 함수는 지정된 핀 대상에서 사용할 ACX 메서드 요청으로 WDFREQUEST 형식을 지정합니다.

구문

NTSTATUS AcxTargetPinFormatRequestForMethod(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

매개 변수

TargetPin

기존 ACXTARGETPIN 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

Request

프레임워크 개체 요약에 설명된 WDFREQUEST 핸들입니다. WDF 요청에 대한 일반적인 내용은 프레임워크 요청 개체 만들기를 참조하세요.

Params

메서드 요청 매개 변수 정보를 저장하는 데 사용되는 초기화된 ACX_REQUEST_PARAMETERS 구조체입니다.

반환 값

호출이 성공하면 를 반환합니다 STATUS_SUCCESS . 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

WDFREQUEST는 I/O 요청을 만든 드라이버입니다. 프레임워크 기반 드라이버는 프레임워크 요청 개체 메서드를 호출하여 각 I/O 요청을 처리합니다. 자세한 내용은 프레임워크 요청 개체를 참조하세요.

예제

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, req, &params);

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항 값
헤더 acxtargets.h
IRQL PASSIVE_LEVEL

추가 정보