WdfDeviceSetStaticStopRemove 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceSetStaticStopRemove 메서드는 디바이스를 중지하고 제거할 수 있는지 여부를 프레임워크에 알릴 수 있습니다.

구문

void WdfDeviceSetStaticStopRemove(
  [in] WDFDEVICE Device,
  [in] BOOLEAN   Stoppable
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] Stoppable

지정된 디바이스를 중지하고 제거할 수 있는지 여부를 나타내는 부울 값입니다. TRUE이면 디바이스를 중지하고 제거할 수 있습니다. FALSE이면 디바이스를 중지하고 제거할 수 없습니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

기본적으로 디바이스를 중지하고 제거할 수 있습니다. 따라서 드라이버는 일반적으로 Stoppable 매개 변수를 FALSE로 일시적으로 설정해야 하는 경우에만 WdfDeviceSetStaticStopRemove를 호출합니다. 예를 들어 DVD 작성기를 제어하는 드라이버는 DVD 레코딩을 시작하기 전에 중지 가능이 FALSE로 설정된 WdfDeviceSetStaticStopRemove를 호출할 수 있습니다. 드라이버가 DVD 레코딩을 완료한 후 중지 가능이 TRUE로 설정된 상태에서 WdfDeviceSetStaticStopRemove를 다시 호출합니다.

드라이버의 디바이스가 특수 파일을 지원하는 경우( WdfDeviceSetSpecialFileSupport 참조) 프레임워크는 디바이스를 중지하거나 제거하는 것을 허용하지 않습니다. 이 경우 드라이버는 WdfDeviceSetStaticStopRemove 를 호출할 필요가 없습니다.

드라이버는 중지 가능이 FALSE로 설정된 WdfDeviceSetStaticStopRemove에 대한 모든 호출과 일치해야 하며 중지 가능이 TRUE로 설정된 WdfDeviceSetStaticStopRemove 호출과 일치해야 합니다.

중지 가능이 FALSE로 설정된 WdfDeviceSetStaticStopRemove를 호출해도 디바이스가 예기치 않게 제거된 경우 프레임워크가 드라이버에 알릴 수 없습니다(깜짝 제거).

운영 체제에서 디바이스를 중지하지 못하게 하는 방법에 대한 자세한 내용은 디바이스 중지 요청 처리를 참조하세요.

예제

다음 코드 예제에서는 지정된 디바이스를 중지하고 제거할 수 없음을 프레임워크에 알릴 수 있습니다.

WdfDeviceSetStaticStopRemove(
                             device,
                             FALSE
                             );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<=DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)