VideoPortReadRegisterBufferUchar function (video.h)

Article
02/22/2024

The VideoPortReadRegisterBufferUchar function reads a number of bytes from a mapped device memory range and writes them into a buffer.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortReadRegisterBufferUchar(
        PUCHAR Register,
  [out] PUCHAR Buffer,
        ULONG  Count
);

Parameters

Register

Pointer to the register. The given Register must be in a mapped memory-space range returned by VideoPortGetDeviceBase.

[out] Buffer

Pointer to a buffer into which the UCHAR values are written.

Count

Specifies the number of bytes to be written to the buffer.

Return value

None

Remarks

The buffer must be large enough to contain at least the specified number of bytes.

A miniport driver's HwVidInterrupt or HwVidSynchronizeExecutionCallback function can call VideoPortReadRegisterBufferUchar.

Callers of VideoPortReadRegisterBufferUchar can be running at any IRQL, provided that the memory pointed to by the Buffer parameter is resident and that pointed to by the Register parameter is resident, mapped device memory.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Desktop
Header	video.h (include Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	See Remarks section.