Dodawanie urządzenia

Ostrzeżenie

UMDF 2 jest najnowszą wersją UMDF i zastępuje UMDF 1. Wszystkie nowe sterowniki UMDF powinny być zapisywane przy użyciu funkcji UMDF 2. Do usługi UMDF 1 nie są dodawane żadne nowe funkcje, a obsługa UMDF 1 na nowszych wersjach systemu Windows 10 jest ograniczona. Sterowniki uniwersalne systemu Windows muszą używać funkcji UMDF 2.

Zarchiwizowane przykłady UMDF 1 można znaleźć w Windows 11, wersja 22H2 - Maj 2022 aktualizacja przykładów sterowników.

Aby uzyskać więcej informacji, zobacz Wprowadzenie do usługi UMDF.

Struktura dodaje obiekt urządzenia dla każdego urządzenia załadowanego w procesie hosta sterownika. Aby dodać urządzenie, struktura wywołuje metodę IDriverEntry::OnDeviceAdd i przekazuje w wywołaniu interfejsy IWDFDriver oraz IWDFDeviceInitialize. Podany interfejs IWDFDeviceInitialize jest prawidłowy tylko przed wywołaniem przez sterownik IWDFDriver::CreateDevice. Sterownik może wywołać następujące metody IWDFDeviceInitialize w celu wykonania następujących operacji:

• Sterownik wywołuje metodę IWDFDeviceInitialize::RetrieveDevicePropertyStore w celu pobrania interfejsu IWDFNamedPropertyStore dla magazynu właściwości urządzenia. Sterownik może użyć IWDFNamedPropertyStore, aby pobrać i ustawić właściwości urządzenia.

• Sterownik wywołuje metodę IWDFDeviceInitialize::SetLockingConstraint, aby określić sposób wywoływania funkcji wywołania zwrotnego przez framework.

• Sterownik wywołuje metodę #B0 #A1 IWDFDeviceInitialize::SetFilter #A2 #C3, aby włączyć urządzenie jako urządzenie filtrujące.

Po tym jak sterownik użyje IWDFDeviceInitialize do zainicjowania urządzenia, przekazuje wskaźnik do IWDFDeviceInitialize w wywołaniu metody IWDFDriver::CreateDevice, aby utworzyć obiekt urządzenia UMDF dla tego urządzenia. Po utworzeniu obiektu urządzenia platformy, sterownik wywołuje metodę IWDFDevice::CreateIoQueue, aby utworzyć kolejki I/O do odczytu i zapisu. W tych wywołaniach IWDFDevice::CreateIoQueue sterownik musi zidentyfikować sposób, w jaki odbiera żądania z kolejki I/O. Aby uzyskać więcej informacji, zobacz Konfigurowanie trybu wysyłania dla kolejki we/wy.