Rate This Document
Findability
Accuracy
Completeness
Readability

Message Receiving Interface

Prototype

int wd_recv(struct wd_queue *q, void **resp);

Function

Receive the accelerator hardware response message from queue q.

Input Description

q: queue

resp: response message (In the case of a single queue and multiple users, resp needs to carry ctx_id (non-zero) in struct wcrypto_tag related to user_data when the response message is sent to ensure that the received response message belongs to the right user.)

Output Description

resp: hardware response message, which is related to the vendor

Return Value Description

1: A response message is received.

0: No response message is received.

A negative value: The receiving action fails and no message is received. (For details about error codes, see WD Message Error Code Interface.)

Usage Instruction

The receiving operations of the same algorithm handle q do not support multi-thread mutual exclusion.

Precautions

You do not need to use this basic interface when using the algorithm layer interfaces.