Udostępnij przez


Hierarchia obiektów frameworku

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 - May 2022 Driver Samples Update.

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

Na poniższym rysunku przedstawiono hierarchię obiektów struktury nadrzędno-podrzędnej.

Hierarchia obiektów nadrzędny-podrzędny umdf.

Zakres istnienia obiektów struktury jest określany przez ich lokalizację w hierarchii i sposób tworzenia obiektów. Zakres istnienia obiektów struktury należy do jednej z następujących kategorii:

  • Struktura kontroluje tworzenie i niszczenie obiektów.

    Struktura tworzy i niszczy obiekty, takie jak obiekt sterownika i obiekt urządzenia, w odpowiedzi na zdarzenia systemowe. Gdy sterownik trybu użytkownika wywołuje metodę IWDFDriver::CreateDevice w celu utworzenia obiektu urządzenia, sterownik może opcjonalnie zarejestrować się w celu powiadomienia przez strukturę przed zniszczeniem obiektu urządzenia.

  • Struktura tworzy obiekt; sterownik kontroluje jednak, kiedy obiekt jest zwalniany.

    Obiekt żądania I/O przestrzega tego wzorca, gdy I/O jest prezentowane sterownikowi. Struktura tworzy obiekt żądania, a okres istnienia obiektu żądania jest prawidłowy, dopóki sterownik nie wywoła metody IWDFIoRequest::Complete .

  • Sterownik tworzy obiekt i kojarzy obiekt z innym obiektem struktury.

    Niektóre obiekty struktury są tworzone przez metodę uwidacznianą przez wystąpienie obiektu struktury nadrzędnej, z którą obiekty mają być skojarzone na potrzeby zarządzania okresem istnienia. Metoda IWDFDevice::CreateIoQueue jest przykładem tego wzorca. Jeśli wywołanie funkcji IWDFDevice::CreateIoQueue powiedzie się, nowo utworzona kolejka I/O jest skojarzona z wystąpieniem urządzenia reprezentowanym przez interfejs IWDFDevice. Gdy obiekt nadrzędny zostanie zniszczony, platforma automatycznie czyści wystąpienia podrzędne. Sterowniki są powiadamiane o tych zdarzeniach, jeśli sterowniki rejestrują odpowiednie funkcje wywołania zwrotnego za pomocą platformy.