ホーム › Storage.ProjectedFileSystem › PRJ_CALLBACKS
PRJ_CALLBACKS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| StartDirectoryEnumerationCallback | PRJ_START_DIRECTORY_ENUMERATION_CB | 8/4 | +0 | +0 | StartDirectoryEnumerationCallback へのポインターです。 |
| EndDirectoryEnumerationCallback | PRJ_END_DIRECTORY_ENUMERATION_CB | 8/4 | +8 | +4 | EndDirectoryEnumerationCallback へのポインターです。 |
| GetDirectoryEnumerationCallback | PRJ_GET_DIRECTORY_ENUMERATION_CB | 8/4 | +16 | +8 | GetDirectoryEnumerationCallback へのポインターです。 |
| GetPlaceholderInfoCallback | PRJ_GET_PLACEHOLDER_INFO_CB | 8/4 | +24 | +12 | GetPlaceholderInformationCallback へのポインターです。 |
| GetFileDataCallback | PRJ_GET_FILE_DATA_CB | 8/4 | +32 | +16 | GetFileDataCallback へのポインターです。 |
| QueryFileNameCallback | PRJ_QUERY_FILE_NAME_CB | 8/4 | +40 | +20 | QueryFileNameCallback へのポインターです。 |
| NotificationCallback | PRJ_NOTIFICATION_CB | 8/4 | +48 | +24 | NotifyOperationCallback へのポインターです。 |
| CancelCommandCallback | PRJ_CANCEL_COMMAND_CB | 8/4 | +56 | +28 | CancelCommandCallback へのポインターです。 |
公式ドキュメント
プロバイダーがコールバックの実装を格納する、コールバックルーチンのセットです。
解説(Remarks)
プロバイダーは、StartDirectoryEnumerationCallback、EndDirectoryEnumerationCallback、GetDirectoryEnumerationCallback、GetPlaceholderInformationCallback、および GetFileDataCallback の実装を提供しなければなりません。
QueryFileNameCallback、NotifyOperationCallback、および CancelCommandCallback の各コールバックは省略可能です。
- プロバイダーが QueryFileNameCallback の実装を提供しない場合、ProjFS はディレクトリ列挙コールバックを呼び出して、プロバイダーのストアにそのファイルパスが存在するかどうかを判断します。
- プロバイダーが NotifyOperationCallback の実装を提供しない場合、そのプロバイダーは ProjFS から一切の通知を受け取りません。
- プロバイダーが CancelCommandCallback の実装を提供しない場合、他のどのコールバックもキャンセルできなくなります。プロバイダーはすべてのコールバックを同期的に処理することになります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PRJ_CALLBACKS (x64 64 / x86 32 バイト)
typedef struct PRJ_CALLBACKS {
PRJ_START_DIRECTORY_ENUMERATION_CB StartDirectoryEnumerationCallback;
PRJ_END_DIRECTORY_ENUMERATION_CB EndDirectoryEnumerationCallback;
PRJ_GET_DIRECTORY_ENUMERATION_CB GetDirectoryEnumerationCallback;
PRJ_GET_PLACEHOLDER_INFO_CB GetPlaceholderInfoCallback;
PRJ_GET_FILE_DATA_CB GetFileDataCallback;
PRJ_QUERY_FILE_NAME_CB QueryFileNameCallback;
PRJ_NOTIFICATION_CB NotificationCallback;
PRJ_CANCEL_COMMAND_CB CancelCommandCallback;
} PRJ_CALLBACKS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PRJ_CALLBACKS
{
public IntPtr StartDirectoryEnumerationCallback;
public IntPtr EndDirectoryEnumerationCallback;
public IntPtr GetDirectoryEnumerationCallback;
public IntPtr GetPlaceholderInfoCallback;
public IntPtr GetFileDataCallback;
public IntPtr QueryFileNameCallback;
public IntPtr NotificationCallback;
public IntPtr CancelCommandCallback;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PRJ_CALLBACKS
Public StartDirectoryEnumerationCallback As IntPtr
Public EndDirectoryEnumerationCallback As IntPtr
Public GetDirectoryEnumerationCallback As IntPtr
Public GetPlaceholderInfoCallback As IntPtr
Public GetFileDataCallback As IntPtr
Public QueryFileNameCallback As IntPtr
Public NotificationCallback As IntPtr
Public CancelCommandCallback As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class PRJ_CALLBACKS(ctypes.Structure):
_fields_ = [
("StartDirectoryEnumerationCallback", ctypes.c_void_p),
("EndDirectoryEnumerationCallback", ctypes.c_void_p),
("GetDirectoryEnumerationCallback", ctypes.c_void_p),
("GetPlaceholderInfoCallback", ctypes.c_void_p),
("GetFileDataCallback", ctypes.c_void_p),
("QueryFileNameCallback", ctypes.c_void_p),
("NotificationCallback", ctypes.c_void_p),
("CancelCommandCallback", ctypes.c_void_p),
]#[repr(C)]
pub struct PRJ_CALLBACKS {
pub StartDirectoryEnumerationCallback: *mut core::ffi::c_void,
pub EndDirectoryEnumerationCallback: *mut core::ffi::c_void,
pub GetDirectoryEnumerationCallback: *mut core::ffi::c_void,
pub GetPlaceholderInfoCallback: *mut core::ffi::c_void,
pub GetFileDataCallback: *mut core::ffi::c_void,
pub QueryFileNameCallback: *mut core::ffi::c_void,
pub NotificationCallback: *mut core::ffi::c_void,
pub CancelCommandCallback: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type PRJ_CALLBACKS struct {
StartDirectoryEnumerationCallback uintptr
EndDirectoryEnumerationCallback uintptr
GetDirectoryEnumerationCallback uintptr
GetPlaceholderInfoCallback uintptr
GetFileDataCallback uintptr
QueryFileNameCallback uintptr
NotificationCallback uintptr
CancelCommandCallback uintptr
}type
PRJ_CALLBACKS = record
StartDirectoryEnumerationCallback: Pointer;
EndDirectoryEnumerationCallback: Pointer;
GetDirectoryEnumerationCallback: Pointer;
GetPlaceholderInfoCallback: Pointer;
GetFileDataCallback: Pointer;
QueryFileNameCallback: Pointer;
NotificationCallback: Pointer;
CancelCommandCallback: Pointer;
end;const PRJ_CALLBACKS = extern struct {
StartDirectoryEnumerationCallback: ?*anyopaque,
EndDirectoryEnumerationCallback: ?*anyopaque,
GetDirectoryEnumerationCallback: ?*anyopaque,
GetPlaceholderInfoCallback: ?*anyopaque,
GetFileDataCallback: ?*anyopaque,
QueryFileNameCallback: ?*anyopaque,
NotificationCallback: ?*anyopaque,
CancelCommandCallback: ?*anyopaque,
};type
PRJ_CALLBACKS {.bycopy.} = object
StartDirectoryEnumerationCallback: pointer
EndDirectoryEnumerationCallback: pointer
GetDirectoryEnumerationCallback: pointer
GetPlaceholderInfoCallback: pointer
GetFileDataCallback: pointer
QueryFileNameCallback: pointer
NotificationCallback: pointer
CancelCommandCallback: pointerstruct PRJ_CALLBACKS
{
void* StartDirectoryEnumerationCallback;
void* EndDirectoryEnumerationCallback;
void* GetDirectoryEnumerationCallback;
void* GetPlaceholderInfoCallback;
void* GetFileDataCallback;
void* QueryFileNameCallback;
void* NotificationCallback;
void* CancelCommandCallback;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PRJ_CALLBACKS サイズ: 32 バイト(x86)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; StartDirectoryEnumerationCallback : PRJ_START_DIRECTORY_ENUMERATION_CB (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; EndDirectoryEnumerationCallback : PRJ_END_DIRECTORY_ENUMERATION_CB (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; GetDirectoryEnumerationCallback : PRJ_GET_DIRECTORY_ENUMERATION_CB (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; GetPlaceholderInfoCallback : PRJ_GET_PLACEHOLDER_INFO_CB (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; GetFileDataCallback : PRJ_GET_FILE_DATA_CB (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; QueryFileNameCallback : PRJ_QUERY_FILE_NAME_CB (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; NotificationCallback : PRJ_NOTIFICATION_CB (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; CancelCommandCallback : PRJ_CANCEL_COMMAND_CB (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PRJ_CALLBACKS サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; StartDirectoryEnumerationCallback : PRJ_START_DIRECTORY_ENUMERATION_CB (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; EndDirectoryEnumerationCallback : PRJ_END_DIRECTORY_ENUMERATION_CB (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; GetDirectoryEnumerationCallback : PRJ_GET_DIRECTORY_ENUMERATION_CB (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; GetPlaceholderInfoCallback : PRJ_GET_PLACEHOLDER_INFO_CB (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; GetFileDataCallback : PRJ_GET_FILE_DATA_CB (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; QueryFileNameCallback : PRJ_QUERY_FILE_NAME_CB (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; NotificationCallback : PRJ_NOTIFICATION_CB (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; CancelCommandCallback : PRJ_CANCEL_COMMAND_CB (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PRJ_CALLBACKS
#field intptr StartDirectoryEnumerationCallback
#field intptr EndDirectoryEnumerationCallback
#field intptr GetDirectoryEnumerationCallback
#field intptr GetPlaceholderInfoCallback
#field intptr GetFileDataCallback
#field intptr QueryFileNameCallback
#field intptr NotificationCallback
#field intptr CancelCommandCallback
#endstruct
stdim st, PRJ_CALLBACKS ; NSTRUCT 変数を確保