EVT_SPB_CONTROLLER_LOCK 콜백 함수(spbcx.h)
SPB 컨트롤러 드라이버의 EvtSpbControllerLock 이벤트 콜백 함수는 버스의 단일 대상 디바이스에 액세스하기 위해 SPB 컨트롤러를 잠급니다.
통사론
EVT_SPB_CONTROLLER_LOCK EvtSpbControllerLock;
void EvtSpbControllerLock(
[in] WDFDEVICE Controller,
[in] SPBTARGET Target,
[in] SPBREQUEST LockRequest
)
{...}
매개 변수
[in] Controller
SPB 컨트롤러를 나타내는 프레임워크 디바이스 개체 대한 WDFDEVICE 핸들입니다.
[in] Target
이 I/O 요청에 대한 대상에 대한 SPBTARGET 핸들입니다. 대상은 버스에 연결된 주변 장치 또는 포트입니다. SPB 프레임워크 확장(SpbCx)은 이전에 대상에 대한 연결을 연 EvtSpbTargetConnect 콜백의 대상에 이 핸들을 할당했습니다.
[in] LockRequest
컨트롤러를 잠그기 위해 I/O 컨트롤 요청에 대한 SPBREQUEST 핸들입니다. SPB 컨트롤러 드라이버는 요청된 작업을 수행하거나 오류 상태를 반환하여 이 요청을 완료해야 합니다. 자세한 내용은 설명참조하세요.
반환 값
없음
발언
SpbCx는 SPB 컨트롤러에 대한 I/O 큐를 관리합니다. SPB 컨트롤러 드라이버가 EvtSpbControllerLock 콜백 함수를 등록하는 경우 SpbCx는 컨트롤러의 클라이언트(주변 드라이버)가 버스의 대상에 IOCTL_SPB_LOCK_CONTROLLER 요청을 보낼 때 이 함수를 호출합니다. LockRequest 매개 변수 값은 이 요청을 캡슐화하는 핸들입니다.
EvtSpbControllerLock 및 EvtSpbControllerUnlock 함수는 보완 작업을 수행합니다. 두 함수는 모두 선택 사항입니다. SPB 컨트롤러 드라이버가 EvtSpbControllerUnlock 함수를 구현하는 경우 드라이버는 EvtSpbControllerLock 함수를 구현할 필요가 없지만 그렇게 할 수 있습니다. 그러나 SPB 컨트롤러 드라이버가 EvtSpbControllerLock 함수를 구현하는 경우 EvtSpbControllerUnlock 함수도 구현해야 합니다. 자세한 내용은 SPB_CONTROLLER_CONFIG주의 사항을 참조하세요.
잠금이 적용되는 동안 컨트롤러는 LockRequest 매개 변수로 지정된 대상이 아닌 버스의 대상에 대한 액세스를 허용해서는 안 됩니다.
SPB 컨트롤러 드라이버가 표준 대상 선택 메커니즘을 일시적으로 재정의하도록 컨트롤러의 모드를 변경해야 하는 경우 EvtSpbControllerLock 콜백 중에 이 작업을 수행할 수 있습니다. 이 모드 변경에 긴 지연이 필요하거나 드라이버가 디바이스 인터럽트를 기다려야 하는 경우 드라이버는 모드 변경을 시작한 다음, 지연 없이 콜백에서 반환해야 합니다. 나중에 드라이버는 타이머 DPC 또는 인터럽트 DPC에서 잠금 작업을 완료할 수 있습니다.
DPC에서 잠금 작업이 완료되면 SPB 컨트롤러 드라이버는 이전에 잠금 작업에 필요한 모든 리소스를 할당해야 합니다.
EvtSpbControllerLock 콜백은 잠금 요청에 실패하지 않아야 합니다. 드라이버 검증 도구 사용하도록 설정된 경우 이러한 오류는 검증 도구 트랩을 트리거합니다. 그러면 플러그 앤 플레이 관리자에게 컨트롤러가 실패했음을 보고합니다. SpbCx는 잠금 요청의 오류를 무시하고 오류를 처리하거나 완화하려고 하지 않습니다.
EvtSpbControllerLock 함수는 값을 반환하지 않습니다. 대신 SPB 컨트롤러 드라이버는 LockRequest 매개 변수로 식별되는 I/O 요청의 완료 상태에서 잠금 작업의 상태를 나타냅니다. 완료 상태를 STATUS_SUCCESS 설정합니다.
SpbCx는 EvtSpbControllerUnlock 이벤트 콜백 함수를 호출하여 EvtSpbControllerLock 콜백에 의해 이전에 잠긴 컨트롤러의 잠금을 해제합니다.
EvtSpbControllerLock 콜백 함수를 등록하려면 SpbDeviceInitialize 메서드를 호출합니다.
EvtSpbControllerLock 함수에 대한 자세한 내용은 처리 Client-Implemented 시퀀스참조하세요.
예제
EvtSpbControllerLock 콜백 함수를 정의하려면 먼저 정의하는 콜백 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 콜백 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.
예를 들어 EvtSpbControllerLockMyEvtSpbControllerLock콜백 함수를 정의하려면 이 코드 예제와 같이 EVT_SPB_CONTROLLER_LOCK 함수 형식을 사용합니다.
EVT_SPB_CONTROLLER_LOCK MyEvtSpbControllerLock;
그런 다음 다음과 같이 콜백 함수를 구현합니다.
_Use_decl_annotations_
VOID
MyEvtSpbControllerLock(
WDFDEVICE Controller,
SPBTARGET Target,
SPBREQUEST LockRequest
)
{ ... }
EVT_SPB_CONTROLLER_LOCK 함수 형식은 Spbcx.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 EVT_SPB_CONTROLLER_LOCK 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 KMDF 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요. Use_decl_annotations대한 자세한 내용은 함수 동작 주석을참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8부터 지원됩니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | spbcx.h |
| IRQL | IRQL <= DISPATCH_LEVEL 호출합니다. |