Invalidates a local memory window. Any in-progress transfers referencing the memory window will fail.
HRESULT Invalidate( [in] ND_RESULT *pResult, [in] INDMemoryWindow *pMw, [in] DWORD Flags );
- pResult [in]
An ND_RESULT structure which will receive the status of the request. The status is set to one of the following status codes:
- pMw [in]
An INDMemoryWindow interface of the memory window to invalidate. Invalidating the window lets the window be bound again to a different region of registered memory.
- Flags [in]
The following flags control the behavior of the operation. You can specify one or both of the following flags:
When you implement this method, you should return the following return values. If you return others, try to use well-known values to aid in debugging issues.
The operation succeeded. Completion status will be returned through the outbound completion queue associated with this endpoint.
The endpoint is not connected.
The request would have exceeded the number of outbound requests allowed on the endpoint. The nOutboundEntries parameter of the INDConnector::CreateEndpoint method specifies the limit.
An endpoint can call this method after receiving notification from a peer that it is done with the memory window. However, typically, the peer calls the INDEndpoint::SendAndInvalidate method to notify you and to invalidate the window itself.
Invalidating a memory window prevents further access to the window. Further references to the memory window in an RDMA Read or Write would result in a fatal error on the endpoint and the connection will be terminated.
|Microsoft Message Passing Interface (MS-MPI)|
Build date: 7/2/2010