Udostępnij przez


Walidacja właściwości dla transferów formatu RAW

Sterownik musi zweryfikować ustawienia właściwości WIA przed transferem danych w formacie RAW. Właściwości WIA muszą być ustawione w następujący sposób:

WIA_IPS_XPOS, WIA_IPS_YPOS
Te właściwości są ustawiane tak samo w przypadku formatu RAW, jak w przypadku innych formatów obrazów. Te właściwości zawierają współrzędne, wyrażone w pikselach, lewego górnego rogu wybranego obrazu.

WIA_IPS_XRES, WIA_IPS_YRES
Te właściwości są ustawiane tak samo w przypadku formatu RAW, jak w przypadku innych formatów obrazów. Te właściwości zawierają bieżącą rozdzielczość poziomą i pionową (odpowiednio) w pikselach na cal dla urządzenia

WIA_IPS_XEXTENT, WIA_IPS_YEXTENT
Te właściwości są ustawiane przez aplikację i są odczytywane i aktualizowane przez sterownik. Ponieważ właściwości mogą zostać zmienione z ich oryginalnych wartości, aplikacja musi odczytać wartość przechowywaną we tych właściwościach podczas przetwarzania strumienia RAW.

WIA_IPA_DEPTH
Ta właściwość zawiera liczbę bitów na piksel. Sterownik ustawia wartość tej właściwości, gdy aplikacja ustawia WIA_IPA_FORMAT na WiaImgFmt_RAW. Suma wszystkich wpisów we właściwości WIA_IPA_RAW_BITS_PER_CHANNEL musi być równa liczbie przechowywanej we właściwości WIA_IPA_DEPTH. WIA_IPA_DEPTH jest zapisywalny, jeśli sterownik obsługuje wiele konfiguracji. Na przykład, dla sterownika obsługującego konfiguracje 32 bity na piksel i 48 bity na piksel, aplikacja może wybrać jedno ustawienie, a sterownik powinien odpowiednio ustawić WIA_IPA_RAW_BITS_PER_CHANNEL oraz inne powiązane właściwości.

WIA_IPA_RAW_BITS_PER_CHANNEL
Ta właściwość jest ustawiana przez sterownik w odpowiedzi na wartość WiaImgFmt_RAW we właściwości WIA_IPA_FORMAT i jest aktualizowana po zmianie WIA_IPA_DATATYPE. Wszystkie wpisy dla WIA_IPA_RAW_BITS_PER_CHANNEL muszą być równe liczbie bitów na piksel przechowywanych w WIA_IPA_DEPTH.

WIA_IPA_CHANNELS_PER_PIXEL
Ta właściwość jest ustawiana przez sterownik na liczbę kanałów na piksel wybranego podtypu RAW w WIA_IPA_DATATYPE.

WIA_IPA_DATATYPE
Gdy WIA_IPA_FORMAT jest ustawiona na WiaImgFmt_RAW, sterownik ustawia tę właściwość na wartość domyślną. Sterownik określa również listę dozwolonych wartości, z których aplikacja może wybrać zmianę wartości domyślnej. Wartość domyślna WIA_IPA_DATATYPE jest wybierana przez sterownik; może to być dowolna wartość zezwalana przez urządzenie.

WIA_IPA_BYTES_PER_LINE
Należy zaktualizować przez minidriver zgodnie z ustawieniami WIA_IPA_FORMAT i WIA_IPA_DATATYPE.

WIA_IPA_ITEM_SIZE
Musi być zero.