CIP_FRAME結構 （61883.h）
CIP_FRAME結構描述要附加至輸入或輸出外掛程式的框架。
語法
typedef struct _CIP_FRAME {
union {
IN PVOID Reserved;
IN PVOID pNext;
};
IN ULONG Flags;
IN PCIP_VALIDATE_ROUTINE pfnValidate;
IN PVOID ValidateContext;
IN PCIP_NOTIFY_ROUTINE pfnNotify;
IN PVOID NotifyContext;
OUT CYCLE_TIME Timestamp;
OUT ULONG Status;
IN OUT PUCHAR Packet;
OUT ULONG CompletedBytes;
} CIP_FRAME, *PCIP_FRAME;
成員
Reserved
pNext
保留供內部使用。
Flags
指定與此框架相關聯的選項。
若要接收封包，旗標 可以是下列其中一項：
CIP_VALIDATE_FIRST_SOURCE
指示 IEC-61883 通訊協定驅動程式在 pfnValidate 呼叫客戶端驅動程式提供的函式， 只驗證第一個來源封包。
CIP_VALIDATE_ALL_SOURCE
指示 IEC-61883 通訊協定驅動程式呼叫用戶端驅動程式提供的函式，pfnValidate 驗證所有來源封包。
若要接收封包，CIP_VALIDATE_XXX可以結合下列其中一項或兩者：
CIP_STRIP_SOURCE_HEADER
指示通訊協定驅動程式移除來源封包內的來源標頭封包。
CIP_USE_SOURCE_HEADER_TIMESTAMP
指示通訊協定驅動程式使用來源標頭封包內找到的時間戳來為框架加上時間戳。
若要傳輸封包，旗標 可以是下列其中一項：
CIP_DV_STYLE_SYT
TimeStamp 的值會格式化為將數據傳輸到數位視訊裝置（SD-DVCR、HD-DVCR 或 SDL-DVCR）。
CIP_AUDIO_STYLE_SYT
TimeStamp 的值會格式化為音訊和音樂數據傳輸至音訊裝置。
若要傳輸或接收封包，旗標 也可以使用下列項目來設定：
CIP_RESET_FRAME_ON_DISCONTINUITY
指示通訊協定驅動程式在畫面開頭繼續停止的數據流，而不是下一個來源封包。
pfnValidate
指向呼叫端提供的函式，以驗證來源封包。 此函式會使用下列原型：參數 ValidateInfo 必須指向包含框架相關信息的 CIP_VALIDATE_INFO 結構。
ULONG
(*PCIP_VALIDATE_ROUTINE) (
IN PCIP_VALIDATE_INFO ValidateInfo
);
ValidateContext
指向 pfnValidate之函式的選擇性呼叫端定義內容。 如果函式不需要內容，ValidateContext 可以 NULL。
pfnNotify
指向當要求框架完成時，通訊協定驅動程式所呼叫的呼叫端提供的函式。 通訊協定驅動程式會在 IRQL = DISPATCH_LEVEL呼叫此函式。
此函式會使用下列原型：
ULONG
(*PCIP_NOTIFY_ROUTINE) (
IN PCIP_NOTIFY_INFO NotifyInfo
);
NotifyContext
指向 pfnNotify 上呼叫端所提供函式的選擇性呼叫端定義內容。 如果函式不需要內容，NotifyContext 可以 NULL。
Timestamp
與框架完成相關聯的時間。
若要接收封包，通訊協定驅動程式會將此成員設定為傳輸框架完成的時間，除非在 Flags中設定CIP_USE_SOURCE_HEADER_TIMESTAMP。
若要傳輸封包，CIP-DV_STYLE_SYT 或CIP_AUDIO_STYLE_SYT 旗標的 表示時間戳的格式。
Status
框架的狀態。 可以是下列其中一項：
CIP_STATUS_SUCCESS
CIP_STATUS_CORRUPT_FRAME
CIP_STATUS_FIRST_FRAME
Packet
指向要使用此框架傳輸或接收之呼叫端所配置數據緩衝區的開頭。 相關聯 Av61883_AttachFrame 要求中指定的框架長度表示緩衝區的大小。
CompletedBytes
要求
| 要求 | 價值 |
|---|---|
| 標頭 | 61883.h （包括 61883.h） |