PdcommGemFormattedProgramSelectionInfo

Struct

Summary of a selection snapshot, filled by pdcomm_gem_formatted_program_selection_snapshot_info().

typedef struct PdcommGemFormattedProgramSelectionInfo { ... } PdcommGemFormattedProgramSelectionInfo

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

Members

command_count

Field

Number of process commands in the selected program; 0 when none is selected.

size_t command_count

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

entry_generation

Field

Entry generation captured at selection; 0 when no program is selected.

uint64_t entry_generation

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

id_format

Field

PPID format, #PDCOMM_SECS_ASCII or #PDCOMM_SECS_BINARY; 0 when no program is selected.

uint8_t id_format

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

reserved

Field

Reserved; all bytes must be 0 before the call and are written as zero.

uint8_t reserved[6]

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

selection_generation

Field

Selection revision of the selection, or the current revision when no program is selected.

uint64_t selection_generation

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

session_generation

Field

Session generation of the selection; 0 when no program is selected.

uint64_t session_generation

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

stale_reason

Field

For the STALE state, one of the reasons 1 to 4; otherwise #PDCOMM_GEM_FORMATTED_PROGRAM_SELECTION_STALE_NONE.

uint32_t stale_reason

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

state

Field

Selection state: #PDCOMM_GEM_FORMATTED_PROGRAM_SELECTION_EMPTY, _READY, or _STALE.

uint32_t state

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

store_revision

Field

Store revision captured at selection; 0 when no program is selected.

uint64_t store_revision

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

struct_size

Field

Structure size; set it to at least sizeof(PdcommGemFormattedProgramSelectionInfo).

size_t struct_size

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

Receives the size written.

valid_for_execution

Field

1 when the state was READY at snapshot time.

uint8_t valid_for_execution

Declared in: #include <pdcomm_gem_formatted_program_selections.h>

version

Field

Set to #PDCOMM_GEM_FORMATTED_PROGRAM_SELECTION_INFO_VERSION before the call.

uint32_t version

Declared in: #include <pdcomm_gem_formatted_program_selections.h>