NDK_FN_WRITE callback function (ndkpi.h)
The NdkWrite (NDK_FN_WRITE) function posts a write request on an NDK queue pair (QP).
Syntax
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
)
{...}
Parameters
[in] pNdkQp
A pointer to an NDK queue pair (QP) object (NDK_QP).
[in, optional] RequestContext
A context value to be returned in the RequestContext member of the NDK_RESULT structure for this request.
pSgl
An array of SGE structures (NDK_SGE) that represent the buffers holding the data to write.
[in] nSge
The number of SGE structures in the array that is specified in the pSgl parameter.
[in] RemoteAddress
The remote address to write to, provided in the local host's byte order. The NDK consumer might have added an offset to the remotely-provided value.
[in] RemoteToken
The remotely-provided memory token, an opaque array of bytes from the NDK consumer.
[in] Flags
A bitwise OR of flags which specifies the operations that are allowed. The following flags are supported:
| Value | Meaning |
|---|---|
|
Indicates the successful completion of this request but does not generate a completion event in the outbound completion queue. However, requests that fail do generate a completion in the completion queue. |
|
Indicates that all prior read requests must be complete before the hardware begins processing this request. |
|
Indicates to the NDK provider that it may defer indicating the request to hardware for processing. For more information about this flag, see NDKPI Deferred Processing Scheme.
Note This flag is supported only in NDKPI 1.2 (Windows Server 2012 R2) and later. |
Return value
The NdkWrite function returns one of the following NTSTATUS codes.
| Return code | Description |
|---|---|
|
The request was posted successfully. A completion entry will be queued to the completion queue (CQ) when the work request is completed. |
|
The queue pair (QP) is not connected. |
|
An error occurred. |
Remarks
NdkWrite posts a write request on a queue pair (QP).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported,Supported in NDIS 6.30 and later. |
| Minimum supported server | Windows Server 2012 |
| Target Platform | Windows |
| Header | ndkpi.h (include Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |
See also
NDKPI Deferred Processing Scheme