Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IPin::QueryId method

The QueryId method retrieves an identifier for the pin.

Syntax


HRESULT QueryId(
  [out] LPWSTR *Id
);

Parameters

Id [out]

Receives a string containing the pin identifier.

Return value

Returns an HRESULT value. Possible values include the following.

Return codeDescription
S_OK

Success.

E_OUTOFMEMORY

Insufficient memory.

E_POINTER

NULL pointer argument.

 

Remarks

This method supports graph persistence. Use this method to save a pin's state, and the IBaseFilter::FindPin method to restore the state. The pin's identifier string is defined by the filter implementation. The identifier must be unique within the filter.

Note  The pin identifier is not necessarily the same as the pin name that the QueryPinInfo method returns.

The filter allocates the returned string using the CoTaskMemAlloc function. The caller must free it using CoTaskMemFree.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Data Flow in the Filter Graph
Error and Success Codes
IPin Interface

 

 

Community Additions

ADD
Show:
© 2015 Microsoft