Skip to content

Commit b4edd29

Browse files
author
Wangsong Jin
committed
Update FrameProcessInfo.md
1 parent 72a19b7 commit b4edd29

1 file changed

Lines changed: 13 additions & 11 deletions

File tree

specs/FrameProcesssInfo.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,12 @@ snapshot collection of `ProcessInfo`s corresponding to all currently
2727
running processes associated with this `ICoreWebView2Environment`
2828
except for crashpad process. This provide the same list of `ProcessInfo`s
2929
as what's provided in `GetProcessInfos`. Plus, this also provide the list
30-
of associated `FrameInfo`s running in the renderer process.
30+
of associated `FrameInfo`s actively running(showing UI elements) in the
31+
renderer process.
3132

3233
* We propose to add the `AssociatedFrameInfo` API to provide a list of
33-
`FrameInfo`s running in the asscociated renderer process.
34+
`FrameInfo`s actively running(showing UI elements) in the asscociated
35+
renderer process.
3436

3537
* We propose extending `CoreWebView2` and `CoreWebView2Frame` to include
3638
the `FrameId` property. This property represents the unique identifier of
@@ -370,11 +372,10 @@ interface ICoreWebView2GetProcessInfosWithDetailsCompletedHandler : IUnknown {
370372
/// A continuation of the ICoreWebView2ProcessInfo interface.
371373
[uuid(982ae768-e2ca-11ed-b5ea-0242ac120002), object, pointer_default(unique)]
372374
interface ICoreWebView2ProcessInfo2 : ICoreWebView2ProcessInfo {
373-
/// Gets the collection of the assocated `FrameInfo`s which are running in that
374-
/// renderer process. Assocated `FrameInfo`s can be `null` if there's no frame
375-
/// running in that renderer process.
376-
/// Note that this is only available when the process `Kind` is
377-
/// `COREWEBVIEW2_PROCESS_KIND_RENDERER`
375+
/// Gets the collection of the assocated `FrameInfo`s which are actively running
376+
/// (showing UI elements) in that renderer process. Assocated `FrameInfo`s is
377+
/// empty if there's no frame running in that renderer process. Note that this
378+
/// is only available when the process `Kind` is `COREWEBVIEW2_PROCESS_KIND_RENDERER`
378379
/// and it's called from `ICoreWebView2GetProcessInfosWithDetailsCompletedHandler`.
379380
/// Else, it returns an empty `FrameInfo` collection.
380381
///
@@ -390,8 +391,8 @@ interface ICoreWebView2Environment14 : ICoreWebView2Environment13 {
390391
/// running processes associated with this `ICoreWebView2Environment` except
391392
/// for crashpad process. This provide the same list of `ProcessInfo`s as
392393
/// what's provided in `GetProcessInfos`. Plus, this provide a list of associated
393-
/// `FrameInfo`s running in the renderer process. Check `AssociatedFrameInfos`
394-
/// for acquiring this detail infos.
394+
/// `FrameInfo`s which are actively running (showing UI elements) in the renderer
395+
/// process. Check `AssociatedFrameInfos` for acquiring this detail infos.
395396
///
396397
/// \snippet ProcessComponent.cpp GetProcessInfosWithDetails
397398
HRESULT GetProcessInfosWithDetails([in] ICoreWebView2GetProcessInfosWithDetailsCompletedHandler* handler);
@@ -408,8 +409,9 @@ interface ICoreWebView2FrameInfo2 : ICoreWebView2FrameInfo {
408409
/// The unique identifier of the frame associated with the current `FrameInfo`.
409410
/// It's the same kind of ID as with the frame ID in `ICoreWebView2` and
410411
/// `ICoreWebView2Frame`. This is only available when it's called from
411-
/// `ICoreWebView2GetProcessInfosWithDetailsCompletedHandler`. Else, it returns `null`.
412-
/// Note that this frame Id could be out of date as it's a snapshot.
412+
/// `ICoreWebView2GetProcessInfosWithDetailsCompletedHandler`. Else, it returns
413+
/// an invalid frame ID `0`.
414+
/// Note that this frame ID could be out of date as it's a snapshot.
413415
[propget] HRESULT FrameId([out, retval] UINT32* id);
414416
}
415417

0 commit comments

Comments
 (0)