KsPinSubmitFrameMdl function

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

Syntax


NTSTATUS KsPinSubmitFrameMdl(
  _In_     PKSPIN           Pin,
  _In_opt_ PMDL             Mdl,
  _In_opt_ PKSSTREAM_HEADER StreamHeader,
  _In_opt_ PVOID            Context
);

Parameters

Pin [in]

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

Mdl [in, optional]

A pointer to a memory descriptor list describing the frame buffer. Optional.

StreamHeader [in, optional]

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

Context [in, optional]

A pointer to a caller-allocated buffer that is passed to the frame return callback registered through KsPinRegisterFrameReturnCallback. This parameter is optional and is solely for the caller's use.

Return value

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

Remarks

The difference between this function and KsPinSubmitFrame is that this function will submit a frame using an MDL structure rather than a data and size argument.

Requirements

Target platform

Universal

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

<=DISPATCH_LEVEL

See also

KsPinSubmitFrame
KsPinRegisterFrameReturnCallback

 

 

Send comments about this topic to Microsoft

Show: