IDE_ADAPTER_CONTROL 콜백 함수(irb.h)

AtaAdapterControl 미니포트 드라이버 루틴은 HBA에서 플러그 앤 플레이(PnP) 및 전원 관리 작업을 수행하기 위해 호출됩니다.

참고

ATA 포트 드라이버 및 ATA 미니포트 드라이버 모델은 나중에 변경되거나 사용할 수 없습니다. 대신 Storport 드라이버 및 Storport 미니포트 드라이버 모델을 사용하는 것이 좋습니다.

구문

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

매개 변수

[in] ControllerExtension

컨트롤러 확장에 대한 포인터입니다.

[in] ControlAction

미니포트 드라이버가 다음 표에 정의된 대로 수행해야 하는 5가지 작업 중 하나입니다.

ControlAction	매개 변수	Description
IdeStart	IDE_CONTROLLER_CONFIGURATION	어댑터가 시작 중임을 나타냅니다. 미니포트 드라이버는 IDE_CONTROLLER_CONFIGURATION 구조체의 멤버를 업데이트해야 합니다. 필요한 경우 미니포트 드라이버는 IDE_CONTROLLER_CONFIGURATION 구조에서 하드웨어 리소스를 가져올 수 있습니다.
IdeStop	없음	미니포트 드라이버는 이 컨트롤러에 할당된 리소스 사용을 중지해야 합니다. 포트 드라이버는 어댑터가 어댑터를 중지하기 전에 어댑터에 의해 노출되는 모든 채널이 중지되도록 보장합니다.
IdePowerUp	없음	어댑터가 켜져 있음을 나타냅니다. 전원 주기에서 유지되지 않는 모든 항목은 IdePowerUp 중에 구성해야 합니다.
IdePowerDown	없음	어댑터가 꺼져 있음을 나타냅니다.
IdeVendorDefined	없음	미니포트 드라이버가 공급업체에서 정의한 제어 작업을 수행해야 했음을 나타냅니다.

[in, out] Parameters

지정된 작업과 연결된 매개 변수입니다.

반환 값

미니포트 드라이버는 요청된 작업의 완료를 승인하려면 TRUE 를 반환해야 합니다. FALSE의 반환 값은 미니포트 드라이버가 작업을 성공적으로 완료할 수 없음을 나타냅니다. 특정 작업에 대한 FALSE 반환 값으로 인해 디바이스 설치가 실패할 수 있습니다.

설명

포트 드라이버는 AtaAdapterControl 루틴을 호출하기 전에 어댑터에 미해결 I/O가 없음을 보장합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	irb.h(Irb.h 포함)

추가 정보

IDE_CONTROLLER_CONFIGURATION