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 |