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를 굽기 시작하기 전에 중지 가능 설정된 WdfDeviceSetStaticStopRemoveFALSE 호출할 수 있습니다. 드라이버가 DVD 레코딩을 완료한 후 중지 가능TRUE설정하여 WdfDeviceSetStaticStopRemove 다시 호출합니다.

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

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

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

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

예시

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

WdfDeviceSetStaticStopRemove(
                             device,
                             FALSE
                             );

요구 사항