Retrieving Data from a Session

The hypervisor retrieves any outstanding received data for the session. Received data is buffered using space that was allocated when the partition was initialized. If there is insufficient free space available when data arrives on the connection, the excess bytes are discarded.

The guest can call the HvRetrieveDebugData hypercall function to request a buffer of the maximum size that HvRetrieveDebugData permits. If no data is available, HvRetrieveDebugData returns an error. If the attempt to retrieve data is successful, more data might still be available; therefore, the caller should process the retrieved data and attempt to retrieve more. This process should be repeated until HvRetrieveDebugData returns an error, which indicates that all pending receive data has been fully retrieved.

Send comments about this topic to Microsoft

Build date: 11/16/2013