Validation Test

[This is preliminary documentation and subject to change.]

The validation test steps through the object one chunk at a time, verifying each individual chunk and all return codes. This function saves all returned STAT_CHUNK objects in a list. The validation test verifies the following:

• Chunk Identifiers are unique and increasing
• STAT_CHUNK.flags is a recognized chunk state (CHUNK_TEXT or CHUNK_VALUE)
• STAT_CHUNK.breakType is a recognized break type (0,1,2,3,4)
• If the filter initialization attributes specify that the filter should only return chunks containing pseudo-properties, idChunkSource must equal 0.
• If chunk is not derived, i.e., it is not a pseudo-property, idChunkSource must equal idChunk.
• GetChunk() returns S_OK or an accepted value (FILTER_E_END_OF_CHUNKS, FILTER_E_LINK_UNAVAILABLE, etc.)
• If the chunk contains text, GetText() returns S_OK, FILTER_S_LAST_TEXT, or FILTER_E_NO_MORE_TEXT.
• If GetText() returns FILTER_S_LAST_TEXT, the next call to GetText() should return FILTER_E_NO_MORE_TEXT.
• If the chunk contains a value, GetValue() returns S_OK or FILTER_E_NO_MORE_VALUES.