ChangerReinitializeUnit 함수(mcd.h)
ChangerReinitializeUnit IOCTL 코드 IOCTL_CHANGER_REINITIALIZE_TRANSPORT사용하여 디바이스 제어 IRP의 디바이스별 측면을 처리합니다.
통사론
NTSTATUS ChangerReinitializeUnit(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
매개 변수
[in] DeviceObject
변경자를 나타내는 디바이스 개체에 대한 포인터입니다.
[in] Irp
IRP에 대한 포인터입니다.
반환 값
체인저가 전송 요소의 재할정을 지원하는 경우 ChangerReinitializeUnit 시스템 포트 드라이버에서 반환된 STATUS_XXX 값 또는 다음 값 중 하나를 반환합니다.
STATUS_SUCCESS
STATUS_INVALID_ELEMENT_ADDRESS
STATUS_INVALID_PARAMETER
STATUS_INSUFFICIENT_RESOURCES
체인저가 전송 요소의 재보정을 지원하지 않으면 ChangerReinitializeUnit은 STATUS_INVALID_DEVICE_REQUEST 반환합니다.
발언
이 루틴은 필수입니다.
ChangerReinitializeUnit 변경자가 해당 전송 요소의 크기를 다시 조정합니다. 체인저에 따라 전송을 "홈" 위치로 반환할 수 있습니다. 일반적으로 체인저 클래스 드라이버는 변경자의 전원이 켜졌거나 호출 애플리케이션이 복구 작업을 시작한 후 ChangerReinitializeUnit을 호출합니다. GET_CHANGER_PARAMETERSFeatures0 CHANGER_DEVICE_REINITIALIZE_CAPABLE 플래그는 변경자의 전송이 이러한 상황에서 재보정을 지원하는지 여부를 나타냅니다.
changer 클래스 드라이버는 ChangerReinitializeUnit호출하기 전에 I/O 스택 위치에서 입력 버퍼 길이를 확인합니다. Irp->SystemBuffer 재보정할 요소를 나타내는 CHANGER_ELEMENT 구조를 가리킵니다.
ChangerReinitializeUnit CDB를 사용하여 SRB를 빌드하여 전송 요소를 배치하고 시스템 포트 드라이버로 보냅니다.
ChangerReinitializeUnit 변경자 클래스 드라이버로 돌아가기 전에 I/O 상태 블록의 정보 필드를 sizeof(CHANGER_ELEMENT)로 설정합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | mcd.h(Mcd.h, Ntddchgr.h 포함) |
| IRQL | PASSIVE_LEVEL |