IWDFIoTarget::FormatRequestForIoctl 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

FormatRequestForIoctl 메서드는 I/O 컨트롤 작업에 대한 I/O 요청 개체의 형식을 지정합니다.

구문

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

매개 변수

[in] pRequest

형식을 지정할 요청 개체의 IWDFIoRequest 인터페이스에 대한 포인터입니다.

[in] IoctlCode

수행할 특정 작업을 식별하는 컨트롤 코드입니다.

[in, optional] pFile

I/O 컨트롤 요청과 연결된 파일 개체의 IWDFFile 인터페이스에 대한 포인터입니다. 기본 I/O 대상의 경우 이 매개 변수는 NULL이 아니어야 합니다.

[in, optional] pInputMemory

요청에 대한 입력 버퍼에 액세스하는 데 사용되는 IWDFMemory 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] pInputMemoryOffset

요청에 대한 입력 메모리 오프셋을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] pOutputMemory

요청에 대한 출력 버퍼에 액세스하는 데 사용되는 IWDFMemory 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] pOutputMemoryOffset

요청에 대한 출력 메모리 오프셋을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

반환 값

FormatRequestForIoctl 은 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.5
머리글	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

추가 정보

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET