Enum NvStruct 

enum NvStruct {
    FunctionList,
    OpenSessionExParams,
    Config,
    RcParams,
    PresetConfig,
    InitializeParams,
    ReconfigureParams,
    RegisterResource,
    MapInputResource,
    CreateBitstreamBuffer,
    PicParams,
    LockBitstream,
    CapsParam,
}

The NVENCAPI structs this encoder must stamp with a per-SDK version word — enumerated here precisely because getting that word exactly right is the whole mechanism that lets one compiled binary satisfy every driver’s version check.

Each NVENCAPI struct carries a version field that the driver validates against the exact word its own SDK defined for that struct, rejecting anything else outright with NV_ENC_ERR_INVALID_VERSION. Only two parts of that packed word move between SDKs — the struct revision (bits 16-23) and the 1<<31 flag — so a session that has down-negotiated to an older API cannot send the compiled 13.0 words; it must stamp each struct with precisely the word that older SDK defined, while a current driver still receives its own native word. Naming the structs here is what lets NvStruct::rev supply the per-version (revision, flag) and nvenc_struct_ver assemble the word.

Variants

FunctionList

OpenSessionExParams

Config

RcParams

PresetConfig

InitializeParams

ReconfigureParams

RegisterResource

MapInputResource

CreateBitstreamBuffer

PicParams

LockBitstream

CapsParam

Implementations

impl NvStruct

fn rev(self, api: u32) -> (u32, bool)

The (struct revision, 1<<31 flag) this struct uses under the SDK identified by the packed API version api ((major<<4)|minor) — the only two sub-fields that move between SDKs, and thus the entire per-version knowledge stamping a struct actually needs.

The revision lands in bits 16-23 of the version word and the flag in bit 31; every other bit is fixed, which is exactly why matching just these two on api reproduces each SDK’s word. The values are transcribed verbatim from nvEncodeAPI.h at the FFmpeg nv-codec-headers tags n10.0.26.2, n11.0.10.3, n11.1.5.3, n12.0.16.1, n12.1.14.0, n12.2.72.0, and n13.0.19.0, so they are ground truth rather than anything derived that could drift. Structs whose layout is stable across those SDKs return a constant pair; the rest match on api. 10.0 is the negotiation floor, so the oldest match arm also covers anything below it.

Trait Implementations

impl Clone for NvStruct

fn clone(&self) -> NvStruct

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for NvStruct

impl Debug for NvStruct

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.