STATUS_BLOCK structure (video.h)

Article
04/01/2021

The STATUS_BLOCK structure is a substructure within the VIDEO_REQUEST_PACKET structure. A miniport driver's HwVidStartIO function must set the status block of each VRP that it gets.

Syntax

typedef struct _STATUS_BLOCK {
  union {
    VP_STATUS Status;
    PVOID     Pointer;
  };
  ULONG_PTR Information;
} STATUS_BLOCK, *PSTATUS_BLOCK;

Members

Status

Indicates the result of the requested operation. This member might be one of the following status codes:

ERROR_INSUFFICIENT_BUFFER

Either the VRP InputBuffer is too small to provide the data required to process the given request or the OutputBuffer is too small to return the requested data.

ERROR_INVALID_FUNCTION

The miniport driver does not handle this request.

ERROR_INVALID_PARAMETER

A parameter in the VRP is invalid.

ERROR_IO_PENDING

An operation has not yet completed.

ERROR_MORE_DATA

The driver has additional data to be returned but has already filled the given VRP OutputBuffer.

ERROR_NOT_ENOUGH_MEMORY

There is insufficient memory to process the request.

NO_ERROR

The requested operation has been carried out and completed successfully.

Pointer

Should be ignored by the miniport driver. This member of the union exists to guarantee field alignment across 32- and 64-bit systems.

Information

Supplies additional information about the completed operation. The meaning of the value varies according to VRP. Generally, this member is used to return the minimum size required for the input buffer if the VRP passes data in the InputBuffer. Alternatively, it contains the number of bytes of data transferred if the requested operation returns data in the VRP OutputBuffer.

Requirements

Requirement	Value
Header	video.h (include Video.h)