PcForwardIrpSynchronous 함수(portcls.h)

  • 아티클

PcForwardIrpSynchronous 함수는 IRP 처리기에서 플러그 앤 플레이 IRP를 PDO(물리적 디바이스 개체)로 전달하는 데 사용됩니다.

구문

PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

매개 변수

[in] DeviceObject

오디오 디바이스의 디바이스 개체에 대한 포인터입니다. 이 매개 변수는 DEVICE_OBJECT 형식의 시스템 구조를 가리킵니다.

[in] Irp

전달할 IRP 에 대한 포인터

반환 값

PcForwardIrpSynchronous 는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

PcForwardIrpSynchronous 를 사용하면 물리적 디바이스 드라이버에서 IRP를 완료할 때까지 다음 PDO가 IRP를 수신하고 차단합니다. 이 시점에서 PcForwardIrpSynchronous 는 차단을 해제하고 호출자에게 반환합니다. 호출자(IRP 처리기)는 결국 STATUS_PENDING 상태 반환해야 합니다. 일반적으로 이 함수를 호출하는 모든 IRP 처리기는 반환 시 IRP_ACTION_FINISH 작업을 지정해야 합니다. 다른 작업을 수행하면 IRP가 물리적 디바이스로 두 번째로 전달됩니다.

PcCompleteIrp 함수는 IRP 처리기가 STATUS_PENDING 반환하고 나중에 IRP를 완료해야 하는 경우에 사용됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcForwardIrpSynchronous 함수를 구현합니다.
대상 플랫폼 유니버설
헤더 portcls.h(Portcls.h 포함)
라이브러리 Portcls.lib
IRQL PASSIVE_LEVEL

추가 정보

DEVICE_OBJECT

IRP

PcCompleteIrp