AVStrMiniFrameReturn routine

An AVStream minidriver's AVStrMiniFrameReturn routine is called when an injected frame has completed its trip around the circuit and is ready to be recycled or freed.

Syntax


PFNKSPINFRAMERETURN AVStrMiniFrameReturn;

void AVStrMiniFrameReturn(
  _In_     PKSPIN   Pin,
  _In_opt_ PVOID    Data,
  _In_opt_ ULONG    Size,
  _In_opt_ PMDL     Mdl,
  _In_opt_ PVOID    Context,
  _In_     NTSTATUS Status
)
{ ... }

Parameters

Pin [in]

Pointer to a KSPIN structure representing the pin on which the frame was injected.

Data [in, optional]

Pointer to the buffer originally specified in the call to KsPinSubmitFrame.

Size [in, optional]

Specifies the size in bytes of Data as originally specified in KsPinSubmitFrame.

Mdl [in, optional]

Pointer to a memory descriptor list describing the injected frame as in the call to KsPinSubmitFrameMdl.

Context [in, optional]

Pointer to the minidriver-supplied context buffer attached to the frame when the frame was injected into the circuit.

Status [in]

Contains a copy of Irp->IoStatus.Status for the IRP to which the requested frame was attached.

Return value

None

Remarks

The minidriver specifies this routine's address in the FrameReturn parameter of a call to KsPinRegisterFrameReturnCallback.

Requirements

Target platform

Desktop

Version

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

Header

Ks.h (include Ks.h)

See also

KsPinRegisterFrameReturnCallback
KsPinSubmitFrameMdl

 

 

Send comments about this topic to Microsoft

Show: