AcxDataFormatListRetrieveNextFormat function (acxdataformat.h)

The AcxDataFormatListRetrieveNextFormat function gets the next ACX data format when iterating an ACX data format list.

Syntax

NTSTATUS AcxDataFormatListRetrieveNextFormat(
  [in]      ACXDATAFORMATLIST             AcxDataFormatList,
  [in, out] PACX_DATAFORMAT_LIST_ITERATOR Iterator,
  [out]     ACXDATAFORMAT                 *Format
);

Parameters

[in] AcxDataFormatList

The ACX data format list from which to get the next ACXDATAFORMAT object.

[in, out] Iterator

Pointer to the ACX_DATAFORMAT_LIST_ITERATOR structure used to iterate AcxDataFormatList.

[out] Format

Pointer to the next ACXDATAFORMAT object in AcxDataFormatList.

Return value

The method returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method might return an appropriate NTSTATUS error code.

Remarks

After AcxDataFormatListRetrieveNextFormat returns, Iterator is updated to point to the next data format in the list after Format.

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement Value
Header acxdataformat.h
IRQL <= DISPATCH_LEVEL

See also