VDD_Get_GrbMem

include vdd.inc

VxDcall VDD_Get_GrbMem


The VDD_Get_GrbMem service return the flat address and allocation bitmap for virtual machine's video memory. This service returns the address of the copy of the memory that was made by the grab routine.

Parameters

EDX

Specifies the system virtual machine handle.

EBX

Specifies the handle of the virtual machine for which to retrieve the memory.

EDI

Specifies the VDD control block pointer.

EBP

Points to the Client_Reg_Struc structure for the virtual machine.

Client_EBX

Specifies the virtual machine handle.

Client_ES

Specifies the selector identifying the segment containing the buffer to receive the VDA_Mem_State.

Client_EDI

Specifies the address of the buffer to receive the VDA_Mem_State.

Client_CX

Specifies the size of the buffer to hold the VDA_Mem_State. This is for debugging purposes only.

Return Value

The Client_CX register contains the number of bytes copied to the buffer. Otherwise, it is zero to indicate an error such as the buffer is too small, an invalid selector, or a call to VDD_Get_GrbMem when no grab is active.

Comments

The allocation of memory to the bitmap is dynamic. The grabber must call this service each time it accesses the memory.

Uses

Flags