uefi-raw: Add EFI_NVM_EXPRESS_PASS_THRU_PROTOCOL bindings

[seijikun]

Added a (only raw for now) binding to EFI_NVM_EXPRESS_PASS_THRU_PROTOCOL [52c78312-8edc-4233-98f2-1a1aa5e388a5].

Checklist

• Sensible git history (for example, squash "typo" or "fix" commits). See the Rewriting History guide for help.
• Update the changelog (if necessary)

[seijikun]

May not make much sense to add this.
Seems like it's not possible to use this interface from a UEFI application outside of a driver context.
Investigating...

Protocol Id is properly announced by Handle, but uefi::boot::open_protocol_exclusive fails with EFI_UNSUPPORTED.

[nicholasbishop]

Seems like it's not possible to use this interface from a UEFI application outside of a driver context.

That's fine, uefi-raw is intended to be useful for firmware/drivers implementations.

[seijikun]

Okay, then I'll convert it back to non-draft state.
I don't want to invest too much time into this if it's not usable in app-context though.
I also can't test it...

If you happen to know how to get this to work in an UEFI application context - tell me please, I need it 😅

[seijikun]

For the eternal archives:

Doesn't work

let nvme_ctrl_handles = boot::find_handles::<NvmExpressPassThru>().unwrap();
for handle in nvme_ctrl_handles {
    println!("Handle: {:?}\r", handle);
    let nvmept = match boot::open_protocol_exclusive::<NvmExpressPassThru>(handle) {
        Ok(nvmept) => nvmept,
        Err(e) => {
            println!("Failed to open protocol: {}", e);
            continue;
        }
    };
    // this point is never reached -> because of EFI_UNSUPPORED during open
    // [...]
}

Works:

(Stolen from @necauqua's opal-uefi-greeter, thank you! 😗)

let block_io_handles = boot::find_handles::<BlockIO>().unwrap();
for handle in block_io_handles {
    let Ok(device_path) = uefi::boot::open_protocol_exclusive::<DevicePath>(handle) else { continue; };
    let mut device_path = &*device_path;
    
    let Ok(nvmept_handle) = boot::locate_device_path::<NvmExpressPassThru>(&mut device_path) else { continue; };
    
    let mut nvmept = match uefi::boot::open_protocol_exclusive::<NvmExpressPassThru>(nvmept_handle) {
        Ok(nvmept) => nvme_pt,
        Err(e) => {
            println!("Failed to open protocol: {}", e);
            return;
        }
    };
    
    // success
    // [...]
}