KsPinSubmitFrame function

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(
  PKSPIN           Pin,
  PVOID            Data,
  ULONG Size       OPTIONAL,
  PKSSTREAM_HEADER StreamHeader,
  PVOID            Context
);

Parameters

Pin

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

Data

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

OPTIONAL

TBD

StreamHeader

A pointer to a KSSTREAM_HEADER structure. The stream header is copied if this parameter is supplied. 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

   
Windows version Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL "<=DISPATCH_LEVEL"

See Also

KsPinRegisterFrameReturnCallback

KsPinSubmitFrameMdl