3.1.4.7.3.4 ServerSyncDriverFilter

  • Article

This complex type contains driver synchronization filter data.

       <s:complexType name="ServerSyncDriverFilter">
         <s:sequence>
           <s:element minOccurs="0" maxOccurs="1" name="DssProtocolVersion" type="tns:Version" />
           <s:element minOccurs="0" maxOccurs="1" name="Anchor" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="Categories" type="tns: ArrayOfIdAndDelta" />
           <s:element minOccurs="0" maxOccurs="1" name="ComputerIds" type="tns:ArrayOfIdAndDelta" />
           <s:element minOccurs="0" maxOccurs="1" name="PnpHardwareIds" type="tns:ArrayOfHardwareIdAndDelta" />
         </s:sequence>
       </s:complexType>

DssProtocolVersion: This field MUST be sent but is ignored by the server.

Anchor: This field SHOULD<42> be set to the anchor returned in the first successful response from this operation. It identifies the point in time that the last GetDriverIdList operation was completed successfully. This field is an opaque string that is not interpreted by Microsoft Update. If Microsoft Update has never called the USS before, this field MUST NOT be present for the first call to this operation.

Categories: This field MUST be present. The format of the field is specified in section 3.1.4.5.3.2. If the array is not empty, it specifies a list of category IDs and whether or not delta-synchronization is to be applied for each update. If empty, then USS will return all matching driver sets/drivers irrespective of OS/category prerequisites. When specified, USS filters only driver sets/drivers that have the correct OS/category prerequisite.

For a category in the array, if the Delta field is set to TRUE, the update server MUST only return driver updates in that category that have changed since the last sync and that match the other filter criteria specified by the ComputerIds and PnpHardwareIds fields. Otherwise, all updates in that categories MUST be returned that match the other criteria specified by the ComputerIds and PnpHardwareIds fields.

ComputerIds: A List of computer hardware Ids that represent a combination of the system management BIOS values put in the device by the OEMs. (Manufacturer, Family, ProductName, SKUNumber, BIOS Vendor, BIOS Version, BIOS Major Release, BIOS Minor Release). This is different from the Categories field, in that the USS MUST return driver sets only if the specified Ids match something. If the array is empty, no driver sets are returned. 

PnpHardwareIds: This field MUST be present. It is a list of device driver hardware Ids that represent the different hardware components available on the client devices. The USS only returns drivers if Microsoft Update specifies PNP Ids in the array and the USS has driver updates for those IDs. If the array is empty, no driver updates are returned.