WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 함수(wdfrequest.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 함수는 드라이버의 WDF_REQUEST_REUSE_PARAMS 구조에서 새 IRP를 설정합니다.

구문

void WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
  [in, out] PWDF_REQUEST_REUSE_PARAMS Params,
  [in]      PIRP                      NewIrp
);

매개 변수

[in, out] Params

호출자가 제공한 WDF_REQUEST_REUSE_PARAMS 구조체에 대한 포인터입니다.

[in] NewIrp

호출자 제공 IRP 구조체에 대한 포인터입니다.

반환 값

없음

설명

드라이버의 WdfRequestReuse 호출에서 새 IRP 구조를 지정하는 경우 드라이버는 먼저 WDF_REQUEST_REUSE_PARAMS_INIT 호출한 다음 WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 호출하여 WDF_REQUEST_REUSE_PARAMS 구조를 초기화해야 합니다.

WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 함수는 구조체의 NewIrp 멤버를 지정된 IRP 포인터로 설정합니다. 또한 구조체의 플래그 멤버에서 WDF_REQUEST_REUSE_SET_NEW_IRP플래그를 설정합니다.

예제

다음 코드 예제에서는 WDF_REQUEST_REUSE_PARAMS 구조를 초기화하고, I/O 요청에 대한 새 IRP 구조를 제공하고, WdfRequestReuse를 호출합니다.

WDF_REQUEST_REUSE_PARAMS  params;
NTSTATUS  status;
PIRP  myIrp;
...
WDF_REQUEST_REUSE_PARAMS_INIT(
                              &params,
                              WDF_REQUEST_REUSE_NO_FLAGS,
                              STATUS_SUCCESS
                              );
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
                                     &params,
                                     myIrp
                                     );
status = WdfRequestReuse(
                         Request,
                         &params
                         );
...