Kategorie elementów WIA

Ten temat dotyczy systemu Windows Vista i nowszych wersji.

Wszystkie elementy w drzewie elementów WIA muszą obsługiwać właściwość WIA_IPA_ITEM_CATEGORY . Ta właściwość identyfikuje kategorię funkcjonalną, do którego należy element. Kategoria określa zestaw flag elementów WIA i właściwości WIA, które są skojarzone z elementem.

WIA definiuje następujące kategorie elementów:

WIA_CATEGORY_ROOT
Element główny w drzewie elementów dla urządzenia skanera WIA reprezentuje urządzenie jako całość. Jeśli urządzenie zawiera funkcję skanera płaskiego, automatycznego podajnika dokumentów (ADF) lub skanowania klisz, elementy reprezentujące te źródła wejściowe są elementami podrzędnymi elementu głównego. Jeśli urządzenie zawiera magazyn, najważniejszym elementem folderu w hierarchii magazynu urządzenia jest element podrzędny elementu głównego. Aplikacja może uzyskać dostęp do informacji o urządzeniu, w tym o stanie, identyfikacji i prawach dostępu, za pośrednictwem właściwości WIA zaimplementowanych w elemencie głównym. Aby uzyskać więcej informacji, zobacz dyskusje na temat właściwości elementu głównego w Implementowanie drzew elementów skanera płaskiego, Implementowanie drzew elementów skanera z podajnikiem i Implementowanie drzew elementów skanera filmowego.

WIA_CATEGORY_FLATBED
Płaski element reprezentuje płaski skan (nazywany również płytą skanową) na urządzeniu skanera WIA. Drzewo elementów WIA dla urządzenia ze spłaszczonym skanowaniem powinno zawierać element płaski, który jest elementem podrzędnym elementu głównego. Ponadto, jeśli urządzenie WIA obsługuje segmentację (na przykład za pomocą filtru segmentacji) lub skanowanie w wielu regionach, ten element płaskiego skanera powinien mieć elementy podrzędne, które również są elementami płaskiego skanera, aby reprezentować poszczególne regiony skanowania. Elementy podrzędne, gdy są obecne, powinny należeć do tej samej kategorii WIA_CATEGORY_FLATBED co ich element nadrzędny i powinny obsługiwać te same właściwości WIA (i mają te same początkowe wartości właściwości) co ich element nadrzędny — z wyjątkiem tego, że pozycje i zakresy elementów podrzędnych są ograniczone do regionów skanowania, które reprezentują. Aplikacja może używać filtru segmentacji sterownika WIA (jeśli został podany) do tworzenia regionów skanowania lub minidriver może automatycznie wykrywać i tworzyć same regiony skanowania. Aplikacja może uzyskać dostęp do funkcji skanowania płaskiego urządzenia za pośrednictwem właściwości WIA zaimplementowanych na elementach płaskich (lub elementach). Aby uzyskać więcej informacji, zobacz Implementowanie drzew elementów skanera płaskiego.

WIA_CATEGORY_FEEDER
Element podajnika reprezentuje automatyczny podajnik dokumentów (ADF) na urządzeniu skanera WIA. (Ta kategoria elementów może również reprezentować podajnik, który nie jest w pełni automatyczny i wymaga ręcznej pomocy użytkownika, ale w tym przypadku minidriver WIA jest odpowiedzialny za sprawdzenie, czy następna strona dokumentu została przesunięta przez podajnik, zanim zostanie zeskanowana). Urządzenie z podajnikiem ADF powinno zawierać element podajnika w drzewie elementów WIA. Element pomocniczy jest elementem podrzędnym elementu głównego. Aplikacja może uzyskać dostęp do funkcji skanowania ADF urządzenia za pośrednictwem właściwości WIA zaimplementowanych w elemencie podajnika. Aby uzyskać więcej informacji, zobacz Implementowanie drzew elementów skanera podajnika.

Jeśli moduł ADF może wykonać skanowanie dwustronne (tj. skanowanie obu stron strony dokumentu) i obsługuje różne ustawienia sterowania dla skanowania przedniej i tylnej strony dokumentu, minidriver WIA powinien zaimplementować element przedni podajnika i element tylny podajnika jako elementy podrzędne elementu podajnika. Aplikacja może uzyskać dostęp do funkcji skanowania przód-tył podajnika ADF za pośrednictwem właściwości WIA zaimplementowanych w przednim elemencie podajnika i tylnym elemencie podajnika. Aby uzyskać więcej informacji na temat tych dwóch elementów, zobacz następujące opisy kategorii.

WIA_CATEGORY_FEEDER_FRONT
Element przedniej strony podajnika reprezentuje ustawienia ADF do skanowania przedniej strony stron dokumentu. Ten element powinien być zaimplementowany przez minidriver WIA dla urządzenia skanującego, które posiada ADF umożliwiający skanowanie dwustronne i obsługującego różne ustawienia sterowania do skanowania przedniej i tylnej strony dokumentu. Urządzenie z usługą ADF, które zawsze używa tych samych ustawień dla obu stron dokumentu, nie wymaga tego elementu. Element wierzchni elementu podającego jest elementem podrzędnym elementu podającego. Aplikacja może uzyskać dostęp do funkcji skanowania z przedniego podajnika ADF za pośrednictwem właściwości WIA zaimplementowanych w elemencie podajnika. Aby uzyskać więcej informacji, zobacz Implementację drzew elementów skanera kanału danych.

WIA_CATEGORY_FEEDER_BACK
Element wsteczny modułu informacyjnego reprezentuje ustawienia usługi ADF służące do skanowania tylnej strony w dokumencie. Ten element powinien zostać zaimplementowany przez minidriver WIA dla urządzenia skanera, które ma usługę ADF, która może przeprowadzać skanowanie dwustronne i obsługuje różne ustawienia sterowania do skanowania przednich i tylnych stron dokumentu. Urządzenie z usługą ADF, które zawsze używa tych samych ustawień dla obu stron dokumentu, nie wymaga tego elementu. Element wsteczny źródła danych jest elementem podrzędnym elementu źródła danych. Aplikacja może uzyskać dostęp do funkcji skanowania tylnym podajnikiem ADF za pośrednictwem właściwości WIA zaimplementowanych na elemencie wstecznym podajnika. Aby uzyskać więcej informacji, zobacz Implementowanie drzew elementów skanera podajnika.

WIA_KATEGORIA_FILM
Element filmowy reprezentuje funkcję skanowania filmu na urządzeniu skanera WIA. Urządzenie, które jest dedykowanym skanerem filmowym lub jest skanerem płaskim wyposażonym w adapter przezroczystości (TPA), powinno zawierać co najmniej jeden element filmowy w drzewie elementów WIA. Element filmu jest elementem podrzędnym elementu głównego lub innego elementu filmu. Element filmowy, który jest podrzędnym elementem głównym, reprezentuje całą powierzchnię skanowania. Ten przedmiot filmowy może mieć elementy podrzędne, które są przedmiotami filmowymi reprezentującymi regiony powierzchni skanowania, odpowiadające poszczególnym klatkom filmowym. Aplikacja może uzyskać dostęp do funkcji skanowania filmów urządzenia za pośrednictwem właściwości WIA zaimplementowanych na elemencie filmowym (lub elementach). Aby uzyskać więcej informacji, zobacz Implementowanie drzew elementów skanera filmów.

WIA_CATEGORY_FOLDER
Element folderu reprezentuje folder znajdujący się w wewnętrznym magazynie urządzenia skanera WIA. Element folderu jest elementem podrzędnym elementu głównego lub innego elementu folderu. Jeśli element folderu ma elementy podrzędne, elementy podrzędne są kombinacją gotowych elementów pliku i elementów folderu. Najbardziej górny element folderu w drzewie elementów jest elementem podrzędnym elementu głównego. Aplikacja może uzyskać dostęp do zawartości folderu i informacji o folderze za pośrednictwem właściwości WIA zaimplementowanych w elemencie folderu. Aby uzyskać więcej informacji, zobacz Magazyn skanera WIA.

KATEGORIA_ZAKOŃCZONY_PLIK
Gotowy element pliku reprezentuje gotowy plik przechowywany w folderze na urządzeniu skanera WIA. Gotowy plik to plik, którego zawartość nie ulegnie zmianie. Ta definicja wyklucza pliki, których zawartość może zmieniać się dynamicznie, na przykład, ponieważ skaner uzyskuje i przetwarza dane obrazu. Gotowy plik jest elementem podrzędnym folderu. Aplikacja może uzyskać dostęp do gotowego pliku i informacji o pliku za pośrednictwem właściwości WIA zaimplementowanych w gotowym elemencie pliku. Aby uzyskać więcej informacji, zobacz Pamięć skanera WIA.

WIA_CATEGORY_AUTO
W systemie Windows 7 lub nowszym element automatyczny reprezentuje ustawienia automatycznej konfiguracji dla urządzenia skanera WIA, które obsługuje automatyczne skanowanie. Ten typ urządzenia może skonfigurować własne ustawienia skanowania zamiast wymagać skonfigurowania ustawień przez aplikację WIA działającą na komputerze stacjonarnym. Jeśli na przykład urządzenie umożliwia użytkownikowi zainicjowanie operacji skanowania z urządzenia (zamiast z interfejsu użytkownika aplikacji) i wybranie źródła danych wejściowych dla operacji z urządzenia, aplikacja może użyć elementu automatycznego do odciążenia, do urządzenia, zadania konfigurowania wybranego źródła wejściowego. Element automatyczny jest elementem podrzędnym elementu głównego. Drzewo WIA zawierające element automatyzowany musi również zawierać co najmniej jeden z następujących elementów: element płaski, element podajnika lub element filmowy. Aplikacja może uzyskać dostęp do funkcji automatycznego skanowania urządzenia za pomocą właściwości WIA zaimplementowanych w elemencie głównym i w elemencie automatycznym. Aby uzyskać więcej informacji, zobacz Właściwości WIA obsługiwane przez element automatyczny.

Każda kategoria elementów WIA ma zestaw wymaganych flag elementów WIA i właściwości WIA, które element w kategorii musi obsługiwać, a ponadto zestaw flag i właściwości, które element może obsługiwać jako opcje. Aby uzyskać podsumowanie flag i właściwości skojarzonych z różnymi kategoriami elementów, zobacz WIA_IPA_ITEM_CATEGORY. Aby uzyskać pełną listę flag elementów WIA, zobacz WIA_IPA_ITEM_FLAGS.