IWDFDevice 인터페이스(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
IWDFDevice 인터페이스는 시스템의 디바이스를 나타내는 디바이스 개체를 노출합니다.
상속
IWDFDevice 인터페이스는 IWDFObject에서 상속됩니다. IWDFDevice 에는 다음과 같은 유형의 멤버도 있습니다.
- 메서드
메서드
IWDFDevice 인터페이스에는 이러한 메서드가 있습니다.
| IWDFDevice::AssignDeviceInterfaceState AssignDeviceInterfaceState 메서드는 디바이스에 대해 지정된 디바이스 인터페이스 instance 사용하거나 사용하지 않도록 설정합니다. |
| IWDFDevice::CommitPnpState CommitPnpState 메서드는 IWDFDevice::SetPnpState 메서드가 설정한 플러그 앤 플레이(PnP) 속성(즉, 켜기, 해제 또는 기본 상태로 설정)의 상태를 커밋합니다. |
| IWDFDevice::ConfigureRequestDispatching ConfigureRequestDispatching 메서드는 지정된 형식의 I/O 요청 큐를 지정된 I/O 큐로 구성합니다. |
| IWDFDevice::CreateDeviceInterface CreateDeviceInterface 메서드는 디바이스 인터페이스 클래스의 instance 만듭니다. |
| IWDFDevice::CreateIoQueue CreateIoQueue 메서드는 디바이스와 연결된 기본 I/O 큐를 구성하거나 디바이스에 대한 보조 I/O 큐를 만듭니다. |
| IWDFDevice::CreateRequest CreateRequest 메서드는 형식이 지정되지 않은 요청 개체를 만듭니다. |
| IWDFDevice::CreateSymbolicLink CreateSymbolicLink 메서드는 디바이스에 대한 기호 링크를 만듭니다. |
| IWDFDevice::CreateWdfFile CreateWdfFile 메서드는 드라이버에서 사용할 파일 개체를 만듭니다. |
| IWDFDevice::GetDefaultIoQueue GetDefaultIoQueue 메서드는 디바이스에 대한 기본 I/O 큐의 인터페이스를 검색합니다. |
| IWDFDevice::GetDefaultIoTarget GetDefaultIoTarget 메서드는 디바이스 instance 대한 기본 I/O 대상의 인터페이스를 검색합니다. |
| IWDFDevice::GetDriver GetDriver 메서드는 디바이스 instance 부모 드라이버 개체에 대한 인터페이스를 검색합니다. |
| IWDFDevice::GetPnpState GetPnpState 메서드는 디바이스의 지정된 PnP(플러그 앤 플레이) 속성이 켜지거나 꺼져 있는지(또는 기본 상태로 설정되었는지) 결정합니다. |
| IWDFDevice::P ostEvent PostEvent 메서드는 드라이버에서 지정된 이벤트를 기다리는 애플리케이션에 비동기적으로 알 수 있습니다. |
| IWDFDevice::RetrieveDeviceInstanceId RetrieveDeviceInstanceId 메서드는 디바이스의 instance 식별자를 검색합니다. |
| IWDFDevice::RetrieveDeviceName RetrieveDeviceName 메서드는 기본 커널 모드 디바이스의 이름을 검색합니다. |
| IWDFDevice::RetrieveDevicePropertyStore RetrieveDevicePropertyStore 메서드는 속성 저장소 인터페이스를 검색합니다. 드라이버는 메서드를 사용하여 레지스트리에 액세스할 수 있습니다. |
| IWDFDevice::SetPnpState SetPnpState 메서드는 디바이스의 지정된 PnP(플러그 앤 플레이) 속성을 켜거나 끕니다(또는 기본 상태로 설정). |
설명
각 디바이스 개체에는 부모 드라이버 개체가 있습니다. 새 디바이스가 시스템에 도착하면 프레임워크는 부모 드라이버의 IDriverEntry::OnDeviceAdd 콜백 함수를 호출하여 드라이버에 도착에 대해 알립니다. 그런 다음 드라이버는 IWDFDriver::CreateDevice 메서드를 호출하여 새 디바이스 개체에 대한 IWDFDevice 인터페이스에 대한 포인터를 받을 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.5 |
| 머리글 | wudfddi.h(Wudfddi.h 포함) |