讀取裝置屬性

應用程式會使用裝置的 IWiaPropertyStorage 介面來讀取和寫入裝置屬性。 IWiaPropertyStorage 會繼承元件物件模型的所有方法， (COM) 介面 IPropertyStorage。

裝置屬性包含描述裝置功能和設定之裝置的相關資訊。 如需這些屬性的清單，請參閱 裝置屬性。

使用 IWiaPropertyStorage 讀取的裝置屬性之一是裝置識別碼，然後用來建立 Windows 映像下載 (WIA) 裝置。 如需詳細資訊，請參閱 IWiaDevMgr：：CreateDevice (或 IWiaDevMgr2：：CreateDevice) 。

下列範例會從裝置屬性的陣列讀取裝置識別碼、裝置名稱和裝置描述，並將這些屬性列印到主控台。

    HRESULT ReadSomeWiaProperties( IWiaPropertyStorage *pWiaPropertyStorage )
    {
        //
        // Validate arguments
        //
        if (NULL == pWiaPropertyStorage)
        {
            return E_INVALIDARG;
        }

        //
        // Declare PROPSPECs and PROPVARIANTs, and initialize them to zero.
        //
        PROPSPEC PropSpec[3] = {0};
        PROPVARIANT PropVar[3] = {0};

        //
        // How many properties are you querying for?
        //
        const ULONG c_nPropertyCount = sizeof(PropSpec)/sizeof(PropSpec[0]);

        //
        // Define which properties you want to read:
        // Device ID.  This is what you would use to create
        // the device.
        //
        PropSpec[0].ulKind = PRSPEC_PROPID;
        PropSpec[0].propid = WIA_DIP_DEV_ID;

        //
        // Device Name
        //
        PropSpec[1].ulKind = PRSPEC_PROPID;
        PropSpec[1].propid = WIA_DIP_DEV_NAME;

        //
        // Device description
        //
        PropSpec[2].ulKind = PRSPEC_PROPID;
        PropSpec[2].propid = WIA_DIP_DEV_DESC;

        //
        // Ask for the property values
        //
        HRESULT hr = pWiaPropertyStorage->ReadMultiple( c_nPropertyCount, PropSpec, PropVar );
        if (SUCCEEDED(hr))
        {
            //
            // IWiaPropertyStorage::ReadMultiple will return S_FALSE if some
            // properties could not be read, so you have to check the return
            // types for each requested item.
            //

            //
            // Check the return type for the device ID
            //
            if (VT_BSTR == PropVar[0].vt)
            {
                //
                // Do something with the device ID
                //
                _tprintf( TEXT("WIA_DIP_DEV_ID: %ws\n"), PropVar[0].bstrVal );
            }

            //
            // Check the return type for the device name
            //
            if (VT_BSTR == PropVar[1].vt)
            {
                //
                // Do something with the device name
                //
                _tprintf( TEXT("WIA_DIP_DEV_NAME: %ws\n"), PropVar[1].bstrVal );
            }

            //
            // Check the return type for the device description
            //
            if (VT_BSTR == PropVar[2].vt)
            {
                //
                // Do something with the device description
                //
                _tprintf( TEXT("WIA_DIP_DEV_DESC: %ws\n"), PropVar[2].bstrVal );
            }

            //
            // Free the returned PROPVARIANTs
            //
            FreePropVariantArray( c_nPropertyCount, PropVar );
        }

        //
        // Return the result of reading the properties
        //
        return hr;
    }

在此範例中，應用程式會分別 (PropSpec 和 PropVar設定PROPVARIANT陣列，) 來保存屬性資訊。 這些陣列會在IWiaPropertyStorage指標pIWiaPropStg的IPropertyStorage：：ReadMultiple方法呼叫中當做參數傳遞。 PropSpec陣列的每個元素都包含裝置屬性的類型和名稱。 傳回時， PropVar 的每個元素都包含 PropSpec 陣列對應專案所代表的 device 屬性值。

應用程式接著會呼叫IWiaPropertyStorage：：ReadMultipleIWiaPropertyStorage 指標 pWiaPropertyStorage 的 IPropertyStorage：：ReadMultiple 屬性，以擷取屬性資訊。

用來讀取和設定裝置屬性的技術與專案屬性相同，唯一的差異在於您呼叫適當方法的 WIA 專案類型。 如需專案屬性的清單，請參閱 專案屬性。