wdfrequest.h 헤더

이 헤더는 wdf에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• Windows 드라이버 프레임워크

wdfrequest.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

함수

WDF_REQUEST_COMPLETION_PARAMS_INIT WDF_REQUEST_COMPLETION_PARAMS_INIT 함수는 WDF_REQUEST_COMPLETION_PARAMS 구조를 초기화합니다.
WDF_REQUEST_FORWARD_OPTIONS_INIT WDF_REQUEST_FORWARD_OPTIONS_INIT 함수는 WDF_REQUEST_FORWARD_OPTIONS 구조를 초기화합니다.
WDF_REQUEST_PARAMETERS_INIT WDF_REQUEST_PARAMETERS_INIT 함수는 WDF_REQUEST_PARAMETERS 구조를 초기화합니다.
WDF_REQUEST_REUSE_PARAMS_INIT WDF_REQUEST_REUSE_PARAMS_INIT 함수는 드라이버의 WDF_REQUEST_REUSE_PARAMS 구조를 초기화합니다.
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP 함수는 드라이버의 WDF_REQUEST_REUSE_PARAMS 구조에서 새 IRP를 설정합니다.
WDF_REQUEST_SEND_OPTIONS_INIT WDF_REQUEST_SEND_OPTIONS_INIT 함수는 드라이버의 WDF_REQUEST_SEND_OPTIONS 구조를 초기화합니다.
WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT 함수는 드라이버의 WDF_REQUEST_SEND_OPTIONS 구조에서 제한 시간 값을 설정합니다.
WdfRequestAllocateTimer WdfRequestAllocateTimer 메서드는 지정된 I/O 요청에 대한 타이머를 할당합니다.
WdfRequestCancelSentRequest WdfRequestCancelSentRequest 메서드는 호출자가 이전에 I/O 대상에 제출한 I/O 요청을 취소하려고 시도합니다.
WdfRequestChangeTarget WdfRequestChangeTarget 메서드는 지정된 I/O 요청을 지정된 I/O 대상으로 보낼 수 있음을 확인합니다.
WdfRequestComplete WdfRequestComplete 메서드는 지정된 I/O 요청을 완료하고 완료 상태 제공합니다.
WdfRequestCompleteWithInformation WdfRequestCompleteWithInformation 메서드는 완료 정보를 저장한 다음 제공된 완료 상태 사용하여 지정된 I/O 요청을 완료합니다.
WdfRequestCompleteWithPriorityBoost WdfRequestCompleteWithPriorityBoost 메서드는 지정된 I/O 요청을 완료하고 완료 상태 제공합니다. 또한 시스템에서 I/O 작업을 요청한 스레드의 런타임 우선 순위를 높이는 데 사용할 수 있는 값을 지정합니다.
WdfRequestCreate WdfRequestCreate 메서드는 빈 프레임워크 요청 개체를 만듭니다.
WdfRequestCreateFromIrp WdfRequestCreateFromIrp 메서드는 지정된 WDM IRP에서 프레임워크 요청 개체를 만듭니다.
WdfRequestFormatRequestUsingCurrentType WdfRequestFormatRequestUsingCurrentType 메서드는 지정된 I/O 요청의 형식을 지정하여 드라이버가 수정되지 않은 상태로 드라이버의 로컬 I/O 대상으로 전달할 수 있도록 합니다.
WdfRequestForwardToIoQueue WdfRequestForwardToIoQueue 메서드는 호출 드라이버의 I/O 큐 중 하나에 I/O 요청을 다시 큐에 추가합니다.
WdfRequestForwardToParentDeviceIoQueue WdfRequestForwardToParentDeviceIoQueue 메서드는 자식 디바이스의 I/O 큐에서 자식 부모 디바이스의 지정된 I/O 큐로 I/O 요청을 다시 큐에 추가합니다.
WdfRequestGetCompletionParams WdfRequestGetCompletionParams 메서드는 지정된 프레임워크 요청 개체와 연결된 I/O 완성 매개 변수를 검색합니다.
WdfRequestGetEffectiveIoType WdfRequestGetEffectiveIoType 메서드는 지정된 I/O 요청의 데이터 버퍼에 UMDF가 사용하는 버퍼 액세스 메서드를 반환합니다.
WdfRequestGetFileObject WdfRequestGetFileObject 메서드는 지정된 I/O 요청과 연결된 프레임워크 파일 개체를 검색합니다.
WdfRequestGetInformation WdfRequestGetInformation 메서드는 지정된 I/O 요청에 대한 완료 상태 정보를 반환합니다.
WdfRequestGetIoQueue WdfRequestGetIoQueue 메서드는 지정된 I/O 요청이 전달된 프레임워크 큐 개체에 대한 핸들을 반환합니다.
WdfRequestGetParameters WdfRequestGetParameters 메서드는 지정된 프레임워크 요청 개체와 연결된 매개 변수를 검색합니다.
WdfRequestGetRequestorMode WdfRequestGetRequestorMode 메서드는 지정된 I/O 요청의 송신자의 프로세서 액세스 모드를 반환합니다.
WdfRequestGetRequestorProcessId WdfRequestGetRequestorProcessId 메서드는 I/O 요청을 보낸 프로세스의 식별자를 검색합니다.
WdfRequestGetStatus WdfRequestGetStatus 메서드는 I/O 요청의 상태 반환합니다.
WdfRequestGetUserModeDriverInitiatedIo WdfRequestGetUserModeDriverInitiatedIo 메서드는 I/O 요청이 UMDF 드라이버에 의해 시작된 것으로 표시되는지 여부를 결정합니다.
WdfRequestImpersonate WdfRequestImpersonate 메서드는 프레임워크가 가장을 위해 호출해야 하는 드라이버 제공 이벤트 콜백 함수를 등록합니다.
WdfRequestIsCanceled WdfRequestIsCanceled 메서드는 I/O 관리자가 지정된 I/O 요청을 취소하려고 했는지 여부를 결정합니다.
WdfRequestIsFrom32BitProcess WdfRequestIsFrom32BitProcess 메서드는 지정된 I/O 요청의 생성자가 32비트 사용자 모드 애플리케이션인지 여부를 확인합니다.
WdfRequestIsFromUserModeDriver WdfRequestIsFromUserModeDriver 메서드는 I/O 요청이 사용자 모드 드라이버 또는 애플리케이션에서 제공되었는지 여부를 나타냅니다.
WdfRequestIsReserved WdfRequestIsReserved 메서드는 지정된 요청 개체가 메모리 부족 상황에서 보장된 진행률을 지원하기 위해 프레임워크가 예약한 개체인지 여부를 결정합니다.
WdfRequestMarkCancelable WdfRequestMarkCancelable 메서드를 사용하면 지정된 I/O 요청을 취소할 수 있습니다.
WdfRequestMarkCancelableEx WdfRequestMarkCancelableEx 메서드를 사용하면 지정된 I/O 요청을 취소할 수 있습니다.
WdfRequestProbeAndLockUserBufferForRead WdfRequestProbeAndLockUserBufferForRead 메서드는 I/O 요청의 사용자 모드 버퍼를 읽을 수 있는지 확인한 다음 드라이버 스택의 드라이버가 버퍼를 읽을 수 있도록 버퍼의 실제 메모리 페이지를 잠급니다.
WdfRequestProbeAndLockUserBufferForWrite WdfRequestProbeAndLockUserBufferForWrite 메서드는 I/O 요청의 사용자 모드 버퍼를 쓸 수 있는지 확인한 다음 드라이버 스택의 드라이버가 버퍼에 쓸 수 있도록 버퍼의 실제 메모리 페이지를 잠급니다.
WdfRequestRequeue WdfRequestRequeue 메서드는 I/O 요청을 드라이버에 전달된 I/O 큐의 헤드에 반환합니다.
WdfRequestRetrieveActivityId WdfRequestRetrieveActivityId 메서드는 I/O 요청과 연결된 현재 활동 식별자를 검색합니다.
WdfRequestRetrieveInputBuffer WdfRequestRetrieveInputBuffer 메서드는 I/O 요청의 입력 버퍼를 검색합니다.
WdfRequestRetrieveInputMemory WdfRequestRetrieveInputMemory 메서드는 I/O 요청의 입력 버퍼를 나타내는 프레임워크 메모리 개체에 대한 핸들을 검색합니다.
WdfRequestRetrieveInputWdmMdl WdfRequestRetrieveInputWdmMdl 메서드는 I/O 요청의 입력 버퍼를 나타내는 MDL(메모리 설명자 목록)을 검색합니다.
WdfRequestRetrieveOutputBuffer WdfRequestRetrieveOutputBuffer 메서드는 I/O 요청의 출력 버퍼를 검색합니다.
WdfRequestRetrieveOutputMemory WdfRequestRetrieveOutputMemory 메서드는 I/O 요청의 출력 버퍼를 나타내는 프레임워크 메모리 개체에 대한 핸들을 검색합니다.
WdfRequestRetrieveOutputWdmMdl WdfRequestRetrieveOutputWdmMdl 메서드는 I/O 요청의 출력 버퍼를 나타내는 MDL(메모리 설명자 목록)을 검색합니다.
WdfRequestRetrieveUnsafeUserInputBuffer WdfRequestRetrieveUnsafeUserInputBuffer 메서드는 데이터 버퍼에 액세스하기 위한 요청의 기술이 버퍼링되거나 직접 I/O가 아닌 경우 I/O 요청의 입력 버퍼를 검색합니다.
WdfRequestRetrieveUnsafeUserOutputBuffer WdfRequestRetrieveUnsafeUserOutputBuffer 메서드는 데이터 버퍼에 액세스하기 위한 요청의 기술이 버퍼링되거나 직접 I/O가 아닌 경우 I/O 요청의 출력 버퍼를 검색합니다.
WdfRequestReuse WdfRequestReuse 메서드는 프레임워크 요청 개체를 다시 초기화하여 다시 사용할 수 있도록 합니다.
WdfRequestSend WdfRequestSend 메서드는 지정된 I/O 요청을 지정된 I/O 대상으로 보냅니다.
WdfRequestSetActivityId WdfRequestSetActivityId 메서드는 활동 식별자를 I/O 요청에 연결합니다.
WdfRequestSetCompletionRoutine WdfRequestSetCompletionRoutine 메서드는 지정된 프레임워크 요청 개체에 대한 완료 루틴을 등록하거나 등록 취소합니다.
WdfRequestSetInformation WdfRequestSetInformation 메서드는 지정된 I/O 요청에 대한 완료 상태 정보를 설정합니다.
WdfRequestSetUserModeDriverInitiatedIo WdfRequestSetUserModeDriverInitiatedIo 메서드는 특정 요청이 UMDF 드라이버에서 온 것처럼 처리되어야 하는 동일한 디바이스 스택의 UMDF 드라이버 아래에 있는 커널 모드 드라이버를 나타냅니다.
WdfRequestStopAcknowledge WdfRequestStopAcknowledge 메서드는 드라이버가 지정된 I/O 요청 처리를 중지했음을 프레임워크에 알릴 수 있습니다.
WdfRequestUnmarkCancelable WdfRequestUnmarkCancelable 메서드는 지정된 I/O 요청의 취소를 사용하지 않도록 설정합니다.
WdfRequestWdmFormatUsingStackLocation WdfRequestWdmFormatUsingStackLocation 메서드는 지정된 WDM I/O 스택 위치 구조체의 내용을 요청의 다음 스택 위치에 복사하여 I/O 요청의 형식을 지정합니다.
WdfRequestWdmGetIrp WdfRequestWdmGetIrp 메서드는 지정된 프레임워크 요청 개체와 연결된 WDM IRP 구조를 반환합니다.

콜백 함수

EVT_WDF_REQUEST_CANCEL 드라이버의 EvtRequestCancel 이벤트 콜백 함수는 I/O 요청이 취소될 때 수행해야 하는 작업을 처리합니다.
EVT_WDF_REQUEST_COMPLETION_ROUTINE 드라이버의 CompletionRoutine 이벤트 콜백 함수는 다른 드라이버가 지정된 I/O 요청을 완료할 때 실행됩니다.
EVT_WDF_REQUEST_IMPERSONATE 드라이버의 EvtRequestImpersonate 이벤트 콜백 함수는 보호된 파일 열기와 같이 요청된 가장 수준에서 작업을 수행합니다.

구조체

WDF_REQUEST_COMPLETION_PARAMS WDF_REQUEST_COMPLETION_PARAMS 구조에는 I/O 요청 완료와 관련된 매개 변수가 포함되어 있습니다.
WDF_REQUEST_FORWARD_OPTIONS WDF_REQUEST_FORWARD_OPTIONS 구조에는 자식 디바이스의 I/O 큐에서 부모 디바이스의 I/O 큐로 I/O 요청을 다시 큐에 넣기 위한 옵션이 포함되어 있습니다.
WDF_REQUEST_PARAMETERS WDF_REQUEST_PARAMETERS 구조체는 I/O 요청과 연결된 매개 변수를 받습니다.
WDF_REQUEST_REUSE_PARAMS WDF_REQUEST_REUSE_PARAMS 구조체는 재사용된 I/O 요청과 연결된 정보를 지정합니다.
WDF_REQUEST_SEND_OPTIONS WDF_REQUEST_SEND_OPTIONS 구조체는 I/O 요청을 I/O 대상으로 보내는 것과 관련된 옵션을 지정합니다.

열거형

WDF_REQUEST_FORWARD_OPTIONS_FLAGS WDF_REQUEST_FORWARD_OPTIONS_FLAGS 열거형 형식은 드라이버의 WDF_REQUEST_FORWARD_OPTIONS 구조에 사용되는 플래그를 정의합니다.
WDF_REQUEST_REUSE_FLAGS WDF_REQUEST_REUSE_FLAGS 열거형 형식은 드라이버의 WDF_REQUEST_REUSE_PARAMS 구조에 사용되는 플래그를 정의합니다.
WDF_REQUEST_SEND_OPTIONS_FLAGS WDF_REQUEST_SEND_OPTIONS_FLAGS 열거형 형식은 드라이버의 WDF_REQUEST_SEND_OPTIONS 구조에 사용되는 플래그를 정의합니다.
WDF_REQUEST_STOP_ACTION_FLAGS WDF_REQUEST_STOP_ACTION_FLAGS 열거형 형식은 프레임워크가 드라이버의 EvtIoStop 콜백 함수에 전달하는 플래그를 정의합니다.
WDF_REQUEST_TYPE WDF_REQUEST_TYPE 열거형 형식은 프레임워크 요청 개체에 포함될 수 있는 요청 유형을 식별합니다.