GetProtocolFromTable

The GetProtocolFromTable function returns a handle to a protocol—based on a given handoff table and value.

HPROTOCOL WINAPIGetProtocolFromTable(LPHANDOFFTABLEhTable,
DWORDItemToFind,
PDWORD_PTRlpInstData);

Parameters

• hTable
  [in] Handle to a handoff table.
• ItemToFind
  [in] Value used to locate the protocol in a handoff table. The value must be available in the protocol data.
• lpInstData
  [out] If available in the handoff table, instance data for the next protocol. Instance data cannot be longer than a DWORD_PTR in length.

Return Values

If the function is successful, the return value is a protocol handle.

If the function is unsuccessful, the return value is NULL.

Remarks

When implementing the RecognizeFrame export function, the GetProtocolFromTable function is used to obtain a handle to the next protocol. The GetProtocolFromTable function is called to retrieve a handle from the next protocol—if the protocol identifies which protocol follows.

Instance data

Instance data can be any data that is less than or equal to a DWORD_PTR in length, or a pointer to data, such as raw frame data, that does not need to be allocated by or freed by the parser.

Requirements

See Also

RecognizeFrame