KsPinSubmitFrame function (ks.h)

If a pin has been placed into injection mode by a call to KsPinRegisterFrameReturnCallback, the KsPinSubmitFrame function submits a frame directly into the transport circuit.

Syntax

KSDDKAPI NTSTATUS KsPinSubmitFrame(
  [in]           PKSPIN           Pin,
  [in, optional] PVOID            Data,
  [in, optional] ULONG            Size,
  [in, optional] PKSSTREAM_HEADER StreamHeader,
  [in, optional] PVOID            Context
);

Parameters

[in] Pin

A pointer to the KSPIN structure on which to submit a frame.

[in, optional] Data

A pointer to a frame buffer. This should be NULL if and only if Size is equal to 0. Optional.

[in, optional] Size

The size in bytes of the frame buffer to which the Data field points. If the Data field is NULL, set this parameter to zero. Optional.

[in, optional] StreamHeader

A pointer to a KSSTREAM_HEADER structure. The stream header is copied if this parameter is supplied. Optional.

[in, optional] Context

A pointer to a caller-allocated buffer. AVStream provides this pointer to the frame return callback registered through a call to KsPinRegisterFrameReturnCallback. Optional.

Return value

Returns STATUS_SUCCESS if frame submission is successful. Otherwise returns an appropriate error code.

Requirements

See also

KsPinRegisterFrameReturnCallback

KsPinSubmitFrameMdl