NDK_FN_WRITE funzione di callback (ndkpi.h)

Articolo
08/07/2023

La funzione NdkWrite (NDK_FN_WRITE) pubblica una richiesta di scrittura in una coppia di code NDK (QP).

Sintassi

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [in]           ULONG Flags
)
{...}

Parametri

[in] pNdkQp

Puntatore a un oggetto QP (NDK Queue Pair) (NDK_QP).

[in, optional] RequestContext

Valore di contesto da restituire nel membro RequestContext della struttura NDK_RESULT per questa richiesta.

pSgl

Matrice di strutture SGE (NDK_SGE) che rappresentano i buffer che contengono i dati da scrivere.

[in] nSge

Numero di strutture SGE nella matrice specificata nel parametro pSgl .

[in] RemoteAddress

Indirizzo remoto da scrivere in, fornito nell'ordine di byte dell'host locale. Il consumer NDK potrebbe aver aggiunto un offset al valore fornito in remoto.

[in] RemoteToken

Token di memoria fornito in remoto, matrice opaca di byte dal consumer NDK.

[in] Flags

Or bit per bit dei flag che specifica le operazioni consentite. Sono supportati i flag seguenti:

Valore	Significato
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	Indica il completamento di questa richiesta, ma non genera un evento di completamento nella coda di completamento in uscita. Tuttavia, le richieste che non riescono generano un completamento nella coda di completamento.
NDK_OP_FLAG_READ_FENCE 0x00000002	Indica che tutte le richieste di lettura precedenti devono essere completate prima che l'hardware inizi a elaborare questa richiesta.
NDK_OP_FLAG_DEFER 0x00000200	Indica al provider NDK che può rinviare la richiesta all'hardware per l'elaborazione. Per altre informazioni su questo flag, vedere Schema di elaborazione posticipata NDKPI. Nota Questo flag è supportato solo in ND KPI 1.2 (Windows Server 2012 R2) e versioni successive.

Valore restituito

La funzione NdkWrite restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta è stata inviata correttamente. Una voce di completamento verrà accodata alla coda di completamento (CQ) al termine della richiesta di lavoro.
STATUS_CONNECTION_INVALID	La coppia di code (QP) non è connessa.
Altri codici di stato	Si è verificato un errore.

Commenti

NdkWrite pubblica una richiesta di scrittura in una coppia di code (QP).

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Vedi anche

Schema di elaborazione posticipato di ND KPI

Requisiti di registrazione delle richieste di lavoro ND KPII

NDK_QP

NDK_RESULT

NDK_SGE