IDeviceIoControl::D eviceIoControlAsync 方法 (deviceaccess.h)
DeviceIoControlAsync 方法會將異步裝置輸入/輸出傳送至指定 CreateDeviceAccessInstance 函式的裝置介面, (I/O) 控制要求。
語法
HRESULT DeviceIoControlAsync(
[in] DWORD ioControlCode,
[in] UCHAR *inputBuffer,
[in] DWORD inputBufferSize,
[out] UCHAR *outputBuffer,
[in] DWORD outputBufferSize,
[in] IDeviceRequestCompletionCallback *requestCompletionCallback,
[out] ULONG_PTR *cancelContext
);
參數
[in] ioControlCode
作業的 I/O 控制件程式代碼。
[in] inputBuffer
作業的選擇性輸入緩衝區。
[in] inputBufferSize
輸入緩衝區的大小,以位元組為單位。
[out] outputBuffer
作業的作業輸出緩衝區。
[in] outputBufferSize
輸出緩衝區的大小,以位元組為單位。
[in] requestCompletionCallback
如果成功提交作業,則會呼叫 RequestCompletion 方法的回呼介面。
[out] cancelContext
選擇性指標,接收可傳遞至 CancelOperation 方法的取消內容,以取消未完成的要求。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果要求已成功提交 (,呼叫此函式並不會立即傳回錯誤) ,則作業的結果可在提供的 IDeviceRequestCompletionCallback 介面的 RequestCompletion 回呼中使用。
系統 (作業系統或設備驅動器) 立即失敗的作業,不會產生回呼。這表示呼叫端只有在此函式傳回 S_OK時,才會收到回呼。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | deviceaccess.h |
程式庫 | Deviceaccess.lib |