IWDFDriver::CreatePreallocatedWdfMemory メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
CreatePreallocatedWdfMemory メソッドは、指定されたバッファーに フレームワーク メモリ オブジェクトを作成します。
構文
HRESULT CreatePreallocatedWdfMemory(
[in] BYTE *pBuff,
[in] SIZE_T BufferSize,
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFMemory **ppWdfMemory
);
パラメーター
[in] pBuff
メモリ オブジェクトのドライバーが提供するデータ バッファーへのポインター。
[in] BufferSize
pBuff が指 データのサイズ (バイト単位)。
[in, optional] pCallbackInterface
IUnknown インターフェイスへのポインター。フレームワークは、新しく作成されたメモリ オブジェクトでドライバーがサブスクライブするオブジェクト関連のイベント コールバック関数を決定するために使用します。 このパラメーターは省略可能です。 ドライバーが通知 必要としない場合、ドライバーは NULL を渡すことができます。 IUnknown インターフェイスは、オブジェクトのクリーンアップと破棄に使用されます。 ドライバーが有効なポインターを渡した場合、フレームワークは、IObjectCleanup インターフェイスの IUnknown インターフェイスで QueryInterface を呼び出します。 フレームワークがドライバーの IObjectCleanup インターフェイス 取得した場合、フレームワークは後でドライバーの IObjectCleanup::OnCleanup メソッドを呼び出して、メモリ オブジェクトがクリーンアップされたことをドライバーに通知できます。
[in, optional] pParentObject
作成されたメモリ オブジェクトの親オブジェクトの IWDFObject インターフェイスへのポインター。 null 場合、ドライバー オブジェクトは既定の親になります。
[out] ppWdfMemory
新しく作成された WDF メモリ オブジェクトの IWDFMemory インターフェイスへのポインターを受け取るバッファーへのポインター。
戻り値
CreatePreallocatedWdfMemory 、操作が成功した場合にS_OKを返します。 それ以外の場合、このメソッドは Winerror.h で定義されているエラー コードの 1 つを返します。
備考
CreatePreallocatedWdfMemory メソッドは、ドライバーが以前に割り当てたり取得したりしたバッファーのフレームワーク メモリ オブジェクトを作成します。
UMDF ドライバーは、既存のメモリ バッファーを表すメモリ オブジェクトを作成する必要がある場合 CreatePreallocatedWdfMemory を呼び出すことができます。 たとえば、ドライバーは、内部 I/O コントロール コードを含む I/O 要求のバッファー内でドライバー定義構造体を受け取る可能性があります。 ドライバーは、CreatePreallocatedWdfMemory を呼び出してメモリ オブジェクトを作成し、ドライバーが I/O ターゲットに構造体を渡すことができるようにすることができます。
UMDF ドライバーが CreatePreallocatedWdfMemory 呼び出した後、ドライバーは IWDFMemory::SetBuffer を呼び出して、CreatePreallocatedWdfMemory 作成 メモリ オブジェクトに別のバッファーを割り当てることができます。
CreatePreallocatedWdfMemory 作成 フレームワーク メモリ オブジェクトが削除された場合、フレームワークは既存のバッファーの割り当てを解除しません。 同様に、IWDFMemory::SetBuffer 呼び出しても、以前に割り当てられたバッファーの割り当てが解除されることはありません。
例
次のコード例は、バッファーのメモリ オブジェクトを作成する方法を示しています。
//
// Allocate a request.
hr = wdfDevice->CreateRequest(NULL, NULL, &request);
// Allocate a buffer and wrap it in a memory object.
// Make the memory object a child of the request.
// When the request object is deleted, the memory object
// is also deleted.
if (SUCCEEDED(hr))
{
buffer = new BYTE[m_HidDescriptor->wReportLength];
if (buffer == NULL)
{
hr = E_OUTOFMEMORY;
}
}
if (SUCCEEDED(hr))
{
CComPtr<IWDFDriver> driver;
wdfDevice->GetDriver(&driver);
hr = driver->CreatePreallocatedWdfMemory(
buffer,
m_HidDescriptor->wReportLength,
NULL,
request,
&memory
);
}
必要条件
| 要件 | 価値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| ターゲット プラットフォーム の | デスクトップ |
| UMDF の最小バージョン を する | 1.5 |
| ヘッダー | wudfddi.h (Wudfddi.h を含む) |
| DLL | WUDFx.dll |
関連項目
IWDFDriver の
IWDFMemory の
IWDFObject の